Skip to main content
Every object in Sendora has one id that you use everywhere: in the app address bar, in API responses, and in API requests. You never need to convert, decode or look up a second id.

​
The one rule

  • An id the API returns can be sent straight back to any endpoint that takes that kind of object.
  • An id you copy from the app address bar is the same value the API uses.
For example, open a campaign in the app. The last part of the address is the campaign’s id:
Send that same value as campaign_id:

​
Where each id comes from

​
Ids that exist only for one job

A few ids are not objects in your workspace. The API creates them for a single piece of work and returns them in the response that started it. They are not shown in the app, and the only place to get one is that response.

​
Why these ids are safe to share

A Sendora id is a random value. It is not derived from anything inside Sendora, so nothing can be worked out from it. Every lookup is limited to the workspace that owns your API key: an id from another workspace returns 404 Not Found, the same as an id that does not exist.

​
If an id is rejected

  • 404: the id does not exist in this workspace. Check that the API key belongs to the workspace that owns the object, and that the id is for the right kind of object (a lead id is not a campaign id).
  • 422: the id is in the wrong place or the wrong shape, or an account id in Save channel assignments is not connected in this workspace. Read the message for the reason.