Ask AI
Open in ChatGPTOpen in ClaudeView as Markdown
APIWebsiteSign inGet started

Organisations and access

Find your organisation id and send it with every request.

  • Getting started
  • 1 min read
  • Updated 13 November 2026
View as Markdown

A person can belong to more than one organisation. Every call that touches workspace data must say which one.

Your token plus the X-Organization-Id header gives your view of one workspace. Owners and admins see everything and other members see their own leads and tickets. A missing header returns a 400 error

Token plus organisation header.

#Find your organisation id

  • The sign-in response includes an organizations list. Use the id value.
  • GET /api/auth/me returns your profile and your organisations too.

#Send it

Request
curl https://api.aozo.in/api/crm/leads \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Organization-Id: ORG_ID"

#What can go wrong

StatusMessageMeaning
400X-Organization-Id header is requiredYou did not send the organisation header.
403Access to the organisation is not allowedYou are not an active member of that organisation.
404Organization not foundThe id does not exist.
Note

Use the same organisation id for the whole session unless you deliberately switch workspace.