Resources / API Reference

API Reference

Build powerful integrations with Cention's RESTful APIs.

API Overview

Cention provides a comprehensive set of APIs to integrate with your applications. All APIs use REST conventions with JSON payloads.

Base URL https://api.cention.io/v1
Authentication Bearer Token (API Key)
Format JSON
Rate Limit 1000 requests/minute

Quick Start

cURL 
curl -X GET "https://api.cention.io/v1/errands" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Available APIs

Choose the API that fits your integration needs

Errand API

Create, read, update, and close errands (tickets). Manage customer conversations programmatically.

GET /errands POST /errands PUT /errands/{id} POST /errands/{id}/close
View Documentation →

Agent API

Manage agents in your contact center. Create, modify, and delete agent accounts.

GET /agents POST /agents PUT /agents/{id} DELETE /agents/{id}
View Documentation →

Chat API

Build custom chat clients. Real-time messaging between customers and agents.

POST /chat/start POST /chat/message GET /chat/history POST /chat/end
View Documentation →

Bot API

Integrate chatbots with Cention. Register bots, send messages, and handle conversations.

POST /bot/register POST /bot/message POST /bot/transfer POST /bot/close
View Documentation →

Library API

Access the knowledge base. Retrieve libraries, categories, and FAQ content.

GET /library GET /library/categories GET /library/questions GET /library/search
View Documentation →

Export API

Trigger and manage data exports. Download errand data, reports, and analytics.

POST /export/errands POST /export/reports GET /export/{id}/status GET /export/{id}/download
View Documentation →

Authentication

All API requests require authentication using an API key. Include your key in the Authorization header.

Getting Your API Key

  1. Log in to your Cention admin panel
  2. Go to Settings → API Keys
  3. Click Generate New Key
  4. Copy and store your key securely
⚠️ Security: Never expose your API key in client-side code. Always make API calls from your server.
Authentication Header 
Authorization: Bearer YOUR_API_KEY
Example Request 
fetch('https://api.cention.io/v1/errands', {
  headers: {
    'Authorization': 'Bearer sk_live_xxx',
    'Content-Type': 'application/json'
  }
});

Webhooks & Callbacks

Receive real-time notifications when events occur

errand.created

Fired when a new errand is created

errand.updated

Fired when an errand is modified

errand.closed

Fired when an errand is closed

chat.started

Fired when a new chat begins

chat.message

Fired when a message is sent

chat.ended

Fired when a chat session ends

Ready to Build?

Get your API key and start integrating Cention with your applications.

Get API Access Contact Developer Support