Developers · v1
Connect OBAOL to your tools
Use a scoped API key to connect your CRM, automation platform, or custom service. The guide is public; data and live requests require a key.
01
Create a key
Sign in, choose only the scopes needed, and copy the token when it appears. It cannot be shown again.
02
Set the base URL
https://emarketing-backend.infra.obaol.com/v103
Send the header
X-API-Key: obaol_live_…Verify with GET /v1/auth/check.
How requests work
PaginationUse page and page_size (1–100). Lists return page, page_size, total, and data.
ErrorsFailures include error.code, error.message, and request_id. Save the request ID for support.
Limits & retriesObserve RateLimit-* and Retry-After headers. Use Idempotency-Key on supported write requests.
Verify a key and inspect effective scopes
GET /auth/check
Scope: Any valid key
curl -X GET 'https://emarketing-backend.infra.obaol.com/v1/auth/check' \ -H 'X-API-Key: <YOUR_OBAOL_KEY>'
Keep keys server-side where possible. Browser requests require your origin on the API CORS allowlist.