Authentication

Authenticate your integration and make your first Core API request.

Get a Core API token

Ask an organization administrator to create a token in Admin Panel → API → Organization tokens and configure the scopes your integration needs. Follow the illustrated token and scope setup guide.

Securely save the token value when it is first shown. Use a Core API organization token; a legacy Integration API key will not work.

Send authenticated requests

Use the base URL supplied by Brella. The examples use:

https://api.brella.io

Sandbox environments use their corresponding sandbox hostname.

Every request should send these headers:

Accept: application/vnd.brella.v4+json
Brella-API-Access-Token: YOUR_TOKEN
Content-Type: application/json

Minimal read example:

curl --request GET \
  --url "https://api.brella.io/api/core/organizations/30/events/319986/leads" \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: YOUR_TOKEN"

Brella-API-Access-Token authenticates Core API integrations.