Users and roles (partner)
Add people at your partner who can use the dashboard and the API, and control what each one can see.
Add people at your partner who can use the dashboard and the API, and control which accounts and locations each one can see.
A partner user's access can be limited to specific accounts or locations. Two users at the same partner can see different lists everywhere in the API. Use this to give a sales rep their own customers, or an ops person a region.
You'll need a partner token.
Prerequisites
- A bearer token in the
Authorizationheader. Any endpoint that needs no token says so on its own page. - The id of each record the call targets. Every endpoint page lists the ids it needs.
Errors
| Status | Meaning |
|---|---|
401 | The bearer token is missing, expired or invalid |
403 | The token is valid but the record sits outside your account |
422 | The request failed validation — the response names the fields |
500 | Unexpected server error |
Individual endpoints may return more; each page lists its own.
Endpoints
List users
GET — Get the users at your partner (or an account) with their role and what they can access.
Add a partner user
POST — Add a person at your partner with a role and access to chosen accounts or locations.
Updated 26 days ago
Did this page help you?
