Create Conversation

POST

/v2/conversations/service-account/create

Creates a conversation for a contact. Returns existing conversation if it exists. Optionally assigns to a user or AI agent.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/json

Examples

Responses

🟢200

application/json

Conversation created or retrieved successfully

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.voxa.sa/v2/conversations/service-account/create' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "ChannelId": "3a197b6e-e0b9-ce63-4664-a4d3eddae5a0",
    "PhoneNumber": "+966500888777",
    "ContactName": "Ahmed Ali",
    "AssignToUserId": null,
    "AssignToAiAgentId": null
}'

Response Example

{
    "conversation": {
        "id": "3a1a4cb7-e7c1-f045-127b-ad2297847528",
        "status": "Open",
        "lastActivityAt": "2026-02-19T01:52:46Z",
        "contactId": "3a18a7e6-48bf-e5b8-4935-867e4b6c6c02",
        "contactName": "Ahmed Ali",
        "phoneNumber": "+966500888777",
        "channelId": "3a197b6e-e0b9-ce63-4664-a4d3eddae5a0",
        "assigneeId": null,
        "assignedAiAgentId": null,
        "isAiAssignee": false,
        "assigneeName": null,
        "tags": [],
        "unreadCount": 0
    },
    "contactId": "3a18a7e6-48bf-e5b8-4935-867e4b6c6c02"
}

Modified at 2026-02-21 23:30:21

List Conversations

Assign Conversation