API REFERENCE

Authentication

Call Camp Studio authenticates requests using bearer tokens. Treat each token like a password - it grants access to your account, so never expose it in client-side code or commit it to a public repository.

Generating Token

To get started, you'll need an API token. You can generate it in the Call Camp Studio under Profile → API tokens. When creating a token, you can give it a descriptive name and assign an expiration date to limit its access. Once it is generated, make sure to copy the token immediately as it will not be shown again.

Sending the Token

API tokens must be sent in the Authorization header of every request. The token should be prefixed with the word Bearer followed by a space.

BASH

curl http://localhost:3000/api/auth/me \
  -H "Authorization: Bearer {{your_callcamp_api_token}}"

Verifying a Token

GEThttp://localhost:3000/api/auth/me

Returns the account associated with the bearer token, including the token name, granted scopes and current rate-limit usage. Use this endpoint to confirm a token is valid before storing it on a server.

Responses

JSON

{
  "token": "cc_tok_8f3a91b2c4d5e6f7a8b9c0d1e2f3a4b5",
  "user": {
    "uuid": "7d4f10a2-2b91-4c2d-5e6f-7a8b9c0d1e2f",
    "email": "user@example.com",
    "name": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "permissions": [
      "campaigns:read",
      "campaigns:write",
      "calls:read"
    ],
    "role": {
      "type": "admin",
      "name": "Administrator"
    },
    "client": {
      "uuid": "2b91c27d-4f10-4d5e-6f7a-8b9c0d1e2f3a",
      "name": "Acme Inc.",
      "type": "growth",
      "status": "active"
    },
    "status": "active",
    "type": "standard",
    "emailVerified": true,
    "tfaEnabled": false
  }
}

Postman Collection

Download our pre-configured Postman collection to start testing all API endpoints immediately. Includes environment variables and authentication templates.

Download JSON