Overview

Before you begin

Generate a Demandbase API token using Authenticate with Demandbase APIs, and confirm the token’s user has permission to use the Admin API. Replace <your auth token> in the example with the token.

Use the Admin API to manage users, permissions, and other administrative functions across your Demandbase account.

Admin API endpoints are restricted to 90 requests per minute per HTTP method (e.g., GET, POST, PUT, DELETE).
If the limit is exceeded, the API will respond with an HTTP 429 – Too Many Requests error.

Recommendations to Stay Within Limits:

• Distribute traffic across time intervals rather than sending bursts
• Batch operations where possible to reduce request volume
• Implement exponential backoff when retrying 429 errors
• Monitor your usage trends and adjust polling or sync frequency accordingly
• Use idempotent design where applicable to safely retry failed requests

curl --location 'https://uapi.demandbase.com/admin/v1/users' \
--header 'Authorization: Bearer <your auth token>'

A 200 OK response confirms the request succeeded. The totalCount gives the number of users returned and data contains their user and permission details. For other operations, choose an endpoint from the Admin API reference and check its required permissions and response schema.

{
  "totalCount": 1,
  "data": [
    {
      "name": "Test User",
      "email": "[email protected]",
      "externalIds": [],
      "permissionSets": [
        "Demandbase One for Sales",
        "General User"
      ],
      "department": "Ad Operations",
      "view": "Standard View",
      "workspaces": [
        "Default workspace"
      ],
      "date_created": "2025-03-11T05:38:17.007Z",
      "jobFunction": "Other"
    }
  ]
}