REremote-com
Company Tokens

Create a new token for a company

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

No recorded changes to this operation across all 1 revision of this API.