Skip to main content
POST
/
v1
/
conversations
Create a conversation
curl --request POST \
  --url https://dev.flextell.ai/api/v1/conversations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "channel_id": 2,
  "address": "<string>",
  "first_name": "<string>",
  "last_name": "<string>"
}
'
{
  "success": "<string>",
  "data": {
    "id": 123,
    "display_name": "<string>",
    "address": "<string>",
    "last_message_id": "<string>",
    "last_message": "<string>",
    "last_message_at": "<string>",
    "last_message_type": "<string>",
    "last_message_is_customer": "<string>",
    "unread_count": "<string>",
    "agent_disabled": true,
    "agent_expires_at": "2023-11-07T05:31:56Z",
    "agent_disabled_by_user_name": "<string>",
    "customer": {
      "id": 123,
      "first_name": "<string>",
      "last_name": "<string>",
      "phone_number": "<string>",
      "avatar_url": "<string>"
    },
    "channel": {
      "id": 123,
      "name": "<string>",
      "type": "<string>",
      "address": "<string>"
    }
  }
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

X-Tenant
number

Tenant identifier. Send the Tenant ID in the X-Tenant header to scope API requests to a specific tenant.

Body

application/json
channel_id
integer
required
Required range: x >= 1
address
string
required
Maximum string length: 255
first_name
string | null
Maximum string length: 255
last_name
string | null
Maximum string length: 255

Response

success
string
required
data
ConversationResource · object
required