The Corebee API is a RESTful API that allows you to programmatically manage conversations, contacts, messages, and more. All requests require authentication via a Supabase JWT token unless noted otherwise.
Include your JWT token in the Authorization header:
curl -X GET https://your-app.com/api/inbox/conversations \ -H "Authorization: Bearer YOUR_JWT_TOKEN" \ -H "Content-Type: application/json"
| Plan | Requests/min | Requests/day |
|---|---|---|
| Trial | 10 | 500 |
| Pro | 60 | 10,000 |
Manage support conversations in your inbox.
/api/inbox/conversationsList conversations with filters for status, assignee, and channel.
/api/inbox/conversationsCreate a new conversation.
/api/inbox/conversations/{id}/statusUpdate conversation status (open, resolved, pending).
/api/inbox/conversations/{id}/assignAssign conversation to an agent or team.
/api/searchGlobal search across conversations, messages, and contacts.
Send and receive messages within conversations.
/api/inbox/conversations/{id}/messagesFetch messages for a conversation with pagination.
/api/inbox/conversations/{id}/messagesSend a message as an agent. For email channels, sends reply via email.
/api/inbox/messages/{id}Get a single message by ID.
/api/inbox/messages/{id}Edit a message.
/api/inbox/messages/{id}Delete a message.
Manage customer contact information.
/api/contacts/{id}Get contact details.
/api/contacts/{id}Update contact information.
/api/contacts/{id}/conversationsList all conversations for a contact.
/api/contacts/{id}/notesList contact notes.
/api/contacts/{id}/notesAdd a note to a contact.
Manage teams and team members.
/api/teamsList all teams.
/api/teamsCreate a new team.
/api/teams/{id}Update a team.
/api/teams/{id}Delete a team.
/api/teams/{id}/membersList team members.
/api/teams/{id}/membersAdd members to a team.
Manage labels for organizing conversations.
/api/labelsList all labels.
/api/labelsCreate a label.
/api/labels/{id}Update a label.
/api/labels/{id}Delete a label.
/api/inbox/conversations/{id}/labelsGet labels for a conversation.
/api/inbox/conversations/{id}/labelsAdd a label to a conversation.
Configure communication channels.
/api/settings/channelsList all channels.
/api/settings/channelsCreate a channel (web_widget or email).
/api/email/inboundWebhook for receiving inbound emails. No auth required.
Manage AI knowledge sources for accurate responses.
/api/knowledge/sourcesList knowledge sources.
/api/knowledge/sourcesCreate a knowledge source (URL, file, or manual).
/api/knowledge/searchSearch knowledge base with RAG retrieval.
/api/knowledge/uploadUpload files for knowledge base.
/api/knowledge/gapsView detected knowledge gaps.
AI-powered tools for agents and automation.
/api/ai/suggestions?conversationId={id}Get AI response suggestions (20/agent/day limit).
/api/ai/summarize?conversationId={id}Get AI conversation summary.
/api/ai/sentimentAnalyze text sentiment.
/api/ai/assistantChat with Corebee Assistant.
/api/ai/translateTranslate message content.
/api/ai/topicsList detected conversation topics.
Workflow automation, SLA policies, and macros.
/api/automation/rulesList automation rules.
/api/automation/rulesCreate an automation rule.
/api/sla/policiesList SLA policies.
/api/sla/policiesCreate an SLA policy.
/api/macrosList macros.
/api/macros/{id}/executeExecute a macro on conversations.
Analytics and performance metrics.
/api/reports/overviewOverview metrics (conversations, response times, resolution rates).
/api/reports/agentsAgent performance metrics.
/api/reports/heatmapConversation heatmap by hour/day.
/api/csat/reportsCSAT performance metrics.
/api/export/conversationsExport conversations to CSV/JSON.
Receive real-time events via webhooks.
/api/webhooksList webhooks.
/api/webhooksCreate a webhook with event subscriptions.
/api/webhooks/{id}Update a webhook.
/api/webhooks/{id}Delete a webhook.
Public endpoints for the embedded chat widget. No authentication required.
/api/widget/configsGet widget configuration by website_token.
/api/widget/messagesList messages for a widget conversation.
/api/widget/messagesSend a message from the widget (triggers AI response).
/api/widget/conversationsGet or resume a widget conversation.
/api/widget/ai-answerGet an AI answer from the knowledge base.
/api/widget/articlesSearch help center articles.
Organization and account settings.
/api/settings/organizationGet organization details.
/api/settings/organizationUpdate organization.
/api/settings/aiGet AI configuration.
/api/settings/aiUpdate AI settings.
/api/billing/checkoutCreate a checkout session.
/api/billing/portalGet billing portal URL.
/api/billing/cancelCancel subscription.
/api/notificationsList notifications.
/api/canned-responsesList canned responses.
/api/healthSystem health check (public).