Partner Configuration
Company Tokens

Create a new token for a company

Changed on

Creates new tokens for a given company, on behalf of the company owner.

Only available to integrations that Remote has allowed to act on behalf of users. Other integrations get a 403.

Authentication

This endpoint requires the following token type:

  • Client credentials access token (OAuth2ClientCredentials) — obtained through the Client Credentials flow or the Refresh Token flow. See Authentication for partners.
post/v1/companies/{company_id}/create-token

Request

  • Base URL: https://gateway.remote.com
  • URL: https://gateway.remote.com/v1/companies/{company_id}/create-token
  • Auth: OAuth 2 (client credentials, token URL /auth/oauth2/token)

Path parameters

company_idstring required

The ID of the company

Query parameters

scopestring

The scope of the token

Response

Success

access_tokenstring required

The OAuth2 access token (JWT). Include this in the Authorization: Bearer <token> header for API requests.

expires_ininteger required

The number of seconds until the access token expires.

refresh_tokenstring required

The refresh token used to obtain a new access token when the current one expires.

Example response

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.cThIIoDvwdueQB468K5xDc5633seEFoqwxjF_xSJyQQ",
  "expires_in": 3600,
  "refresh_token": "16ab2c69-fd3c-4112-855d-2052baa10d20"
}

Changes