Odal API Reference

Odal

Authentication

Bearer Token

All API requests require a Bearer token in the Authorization header. Create API keys in your workspace Settings under API Keys.
curl --request GET \
  --url https://odal.io/api/v1/contacts \
  --header 'Authorization: Bearer odal_your_api_key_here'

API Key Format

All Odal API keys are prefixed with odal_ followed by a 64-character hex string. Keys are hashed on the server — the full key is only shown once at creation time. Store it securely.

Scopes

Each API key is assigned one or more scopes that control which endpoints it can access. If a request requires a scope the key does not have, a 403 response with category MISSING_SCOPES is returned. Available scope categories: CRM Objects, Associations & Tags, Custom Properties, Settings, Analytics, and Automation.