Build on BlueSales. Manage Blues, business profiles, brains, leads, and more — all programmatically.
https://api-v2.bluesales.ai/functions/v1All requests require an X-API-Key header. Generate keys in Dashboard → API.
GET https://api-v2.bluesales.ai/functions/v1/api/blues
X-API-Key: bsk_your_api_key_hereKeep your key secret. Never expose it in client-side code. Each key has scoped permissions and rate limits.
Each key has a set of permissions. Attempting an action without the required permission returns 403 Forbidden.
Blues are your AI voice agents. You can create them entirely via API, including creating their business profile, brain, and other resources in a single request using inline objects.
Knowledge bases for your Blues. Text and website brains can be created via API. File-based brains require the dashboard.
Import phone numbers from your own Twilio account or read existing ones.
Supports Google Calendar, Microsoft Outlook, and a webhook (bring-your-own-calendar) mode for white-label setups where you hold your users' tokens yourself.
Trigger immediate outbound calls and retrieve call history programmatically.
All errors return JSON with an error string.
{ "error": "Missing permission: blues:write" }| Status | Meaning |
|---|---|
| 200 | OK |
| 201 | Created |
| 400 | Bad Request — missing or invalid fields |
| 401 | Unauthorized — invalid or missing API key |
| 403 | Forbidden — API key lacks required permission |
| 404 | Not Found |
| 405 | Method Not Allowed |
| 500 | Server Error |
Need help? Open your API dashboard to manage keys and view request logs.