Developers / API reference
One REST API for campaigns, creative, content and leads.
Everything you can do in the BuzinessAI workspace is available over a predictable, resource-oriented API — so you can launch campaigns, render designs, schedule posts and sync leads from your own systems.
curl https://api.buziness.ai/v1/leads \
-H "Authorization: Bearer $BUZINESS_SECRET_KEY" \
-d name="Asha Rao" \
-d email="asha@example.com" \
-d source="meta_lead_form" \
-d campaign="cmp_8Hq2Lx"Predictable resources
Every Expert maps to plain REST resources with JSON responses, standard HTTP verbs and consistent error codes.
Test and live keys
Build against test keys that never spend budget or publish content, then swap in a live key when you're ready.
Safe to retry
Idempotency keys on every write and cursor-based pagination on every list, so network hiccups never duplicate work.
Core endpoints. The resources most integrations start with.
- POST/v1/campaignsCreate a Meta or Google campaign draft
- GET/v1/campaigns/{id}/insightsSpend, reach and results for a campaign
- POST/v1/audiencesSave a reusable audience for future campaigns
- POST/v1/designs/{id}/renderRender a design template to an image
- POST/v1/postsSchedule a post across connected channels
- GET/v1/leadsList leads with campaign attribution attached
- PATCH/v1/leads/{id}Move a lead to a new pipeline stage
- POST/v1/webhook_endpointsRegister an endpoint to receive events
Make your first call. From zero to a working request in three steps.
- 01
Grab your test key
Every workspace comes with a test secret key in Settings → Developers. Keep it on your server, never in the browser.
- 02
Send a request
Authenticate with a bearer token and create your first test lead.
terminal curl https://api.buziness.ai/v1/leads \ -H "Authorization: Bearer $BUZINESS_SECRET_KEY" - 03
Go live
Swap the test key for a live key. The requests, responses and objects stay exactly the same.
Ready to start building?
Get an API key, follow the quickstart and send your first request in minutes.