Getting a Company Integrator Token
A company integrator access token grants permission for a third-party to access a particular company and some or all of its sites. The access level depends on the assigned company role.
To obtain an access token:
Send a POST request to /v1/company-integrator/access-token, with a
keyandsecretin the body of the request. The example below shows the URL and request body:Company Integrator Token URL
{{pb_url}}/v1/company-integrator/access-tokenIntegrator Token Request Body
{ "key": "{{key_id}}", "secret": "{{secret_key}}", "company_id": "{{company_id}}" }The request response contains a string which serves as the authorization token for future calls to our API resources.
POST /v1/company-integrator/access-token
Summary
Use the POST /v1/company-integrator/access-token endpoint to generate a company integrator (access) token for a particular company and its sites.
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes |
|
header |
| string | Yes | The integrator token created previously |
body |
| Yes | The key identifier, secret key, and company identifier (ID) used to obtain a company integrator token |
Responses
Code | Description |
|---|---|
200 | Success Message: Token returned in response body. |
401 | Error Message: Invalid credentials provided. |
PostCompanyIntegratorTokenRequestBody
Field Name | Type | Required | Description |
|---|---|---|---|
| string | Yes | The key identifier for the integrator |
| string | Yes | The secret key for the integrator |
| string | Yes | The target company unique identifier (UID) for which a token should be generated |