Skip to main content
POST
/
api
/
v1
/
accounts
/
{account_id}
/
contacts
/
{id}
/
contact_inboxes
Create contact inbox
curl --request POST \
  --url https://app.chatwoot.com/api/v1/accounts/{account_id}/contacts/{id}/contact_inboxes \
  --header 'Content-Type: application/json' \
  --header 'api_access_token: <api-key>' \
  --data '
{
  "inbox_id": 1,
  "source_id": "<string>"
}
'
{
  "source_id": "<string>",
  "inbox": {
    "id": 123,
    "avatar_url": "<string>",
    "channel_id": 123,
    "name": "<string>",
    "channel_type": "<string>",
    "provider": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://developers.chatwoot.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
api_access_token
string
header
required

This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user.

Path Parameters

​
account_id
integer
required

The numeric ID of the account

​
id
number
required

ID of the contact

Body

application/json
​
inbox_id
number
required

The ID of the inbox

Example:

1

​
source_id
string

Contact Inbox Source Id

Response

Success

​
source_id
string

Contact Inbox Source Id

​
inbox
object