Skip to main content
You can create and manage API keys directly from the Dealroom dashboard, without writing any code. Go to Settings > API in your Dealroom dashboard: 
https://{your-dealroom-domain}/settings/api

​
Create a new key

  1. Click Create API Key.
  2. Enter a descriptive name (e.g. Production — Data Pipeline).
  3. Select the permissions your integration needs. You can only grant permissions you already hold.
  4. Click Create.
The client_secret is displayed only once after creation. Copy both the client_id and client_secret and store them securely. If lost, revoke the key and create a new one.

​
Exchange credentials for a token

Use the client_id and client_secret to obtain a Bearer token: 
curl -X POST https://accounts.staging.dealroom.dev/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "audience": "https://api-next.staging.dealroom.dev",
    "grant_type": "client_credentials"
  }'
The response contains an access_token valid for 24 hours. Cache and reuse it.

​
Usage dashboard

After making API requests, the usage dashboard shows:
  • Total requests — aggregated request count over time
  • Endpoint breakdown — which endpoints are being called and how often
  • Last used — when each key was last active
Usage data may take up to 60 seconds to appear after requests are made.

​
Revoking a key

To revoke a key, click the delete icon next to it in the API settings page, or call: 
curl -X DELETE https://api.dealroom.co/api/api-keys/{id} \
  -H "Authorization: Bearer $USER_TOKEN"
Revocation is immediate — any tokens issued from the revoked key will stop working.

​
Next steps

  • See Authentication for the full programmatic API key creation flow.
  • Follow the Quickstart to make your first API request.