Authentication

Every request to the RankLadder API is authenticated with a per-business API key sent in the Authorization header.

Base URL

https://app.rankladder.app/api/v1

Get an API key

1. In RankLadder, open the Connections page.
2. Scroll to the Automation section and pick the Zapier or Make card.
3. Click Generate API key.
4. Copy the key right away. It is shown exactly once. RankLadder stores only a hash of it, so it can never be displayed again.

Keys look like this:

rl_zapier_9f2c4e...   (generated from the Zapier card)
rl_make_7a1b3d...     (generated from the Make card)

The two cards issue separate keys, one per platform. Clicking Generate new key rotates the key: the old one stops working immediately.

The automation API is included on the Pro and Scale plans. The trial includes it too.

Send the key

Pass the key as a Bearer token on every request:

curl https://app.rankladder.app/api/v1/hooks \
  -H "Authorization: Bearer rl_zapier_YOUR_KEY"

Verify a key

GET /api/v1/me

Returns which business the key belongs to. Useful to confirm a key is valid, or to label a connection in a tool like Zapier or Make.

{ "business_name": "Sam Alvarez Plumbing" }

Revoking a key

Click Revoke on the card to delete the key. Revoking also deletes every webhook subscription created with that key, so any workflow still using it goes quiet and its next request fails.

Errors

A missing, malformed, rotated, or revoked key returns:

HTTP 401
{ "error": "unauthorized" }