How to Connect to Remote

This guide walks you through generating an API token from Remote to connect your account.

• Prerequisites
• Generate Your API Token
• Vault Connection Setup

Prerequisites

• Admin access - Only company admins or company owners can create and revoke API tokens
• Active Remote account - You must have an active Remote company account

Generate Your API Token

Follow these steps to generate an API token in Remote:

1. Log in to your Remote account.

2. Navigate to Company → Company Settings → Integrations & APIs → Integrations.

3. Click on the Remote API card.

4. Click the Generate API token button.

5. When prompted, enter a name for your API token (e.g., "Apideck Integration").

6. Accept the Remote API Terms of Use agreement.

7. Your new token will appear in the table. Copy the token value - you'll need this for the Vault setup.

Environment

Remote API tokens are environment-specific:

• Production tokens start with ra_live_ and work with the production API (https://gateway.remote.com/)
• Sandbox tokens start with ra_test_ and work only in the sandbox environment (https://gateway.remote-sandbox.com/)

Make sure to select the matching environment in the Vault connection settings below.

Vault Connection Setup

Enter your API token in Vault and select the appropriate environment:

• API Token - The token you generated in Remote (starts with ra_live_ or ra_test_)
• Environment - Select Production for live data or Sandbox for testing

Click Save to complete the connection.

You're connected now!

Known Limitations

• Time-off requests are created as approved — Remote's API currently only supports creating time-off requests with status: approved. Requests cannot be created in requested state via the API.

Revoking Tokens

To revoke a token:

1. Navigate to Company → Company Settings → Integrations & APIs → Integrations
2. Click on the Remote API card
3. Locate the token you want to revoke in the table
4. Click the three-dot menu next to the token
5. Select the revoke option
6. Confirm the deletion

Revoked tokens cannot be recovered - you'll need to generate a new token if needed.