API reference

Conversation import

Bring conversation history from another tool into the inbox, up to 200 per call, without sending any message, without a charge and without duplicates.

1 operation
Base URLhttps://api.messages.ccxcompany.co
AuthenticationBearer with your API key

The technical text below comes from the public contract, openapi.json, in the language the contract was written in.

Import historical conversations into the Inbox

POST/conversations/import

Bulk-imports historical conversations (up to 200 per request) with their text messages, writing Conversation + Message documents directly — no message is sent, nothing is charged. Idempotent per (numberId, contactPhone): an existing conversation for that number+phone is skipped, never duplicated. Message at is the original timestamp, so history sorts correctly in the Inbox.

Responses

200Default Response
Response fields and example
JSON
```
{}
```
401RFC 7807 problem details for UNAUTHORIZED (401).
403RFC 7807 problem details for FORBIDDEN (403).
422RFC 7807 problem details for VALIDATION_ERROR (422).

Error responses follow RFC 7807 (application/problem+json), with a stable code in the code field. See the error codes

curl example

cURL

curl -X POST 'https://api.messages.ccxcompany.co/conversations/import' \  -H "Authorization: Bearer $CCX_API_KEY"

Required fields only. Swap the sample values for your own.

Stuck on a route? Talk to the people who run the API.

Start free Talk to sales

Conversation import

Import historical conversations into the Inbox

Responses

curl example

Other API areas

Stuck on a route? Talk to the people who run the API.