BetaThe v2 API is in beta — fields and behavior may change without notice. For stable production usage, see the API v1 Reference.

Contacts

Create contacts for a chatbot

Send 1–1000 contacts in a single request. Each contact must have an external_id; everything else is optional.

Endpoint

text
POST https://services.chatmount.co/v2/chatbots/:chatbotId/contacts

Request body

json
{
  "users": [
    {
      "external_id": "user_123",
      "name": "John Doe",
      "email": "john@example.com",
      "phonenumber": "+1234567890",
      "custom_attributes": {
        "department": "Sales",
        "subscription_tier": "Premium"
      }
    }
  ]
}
  • external_id (string, required) — your system’s ID
  • Optional: name, email, phonenumber, stripe_accounts, custom_attributes

Response

json
{
  "message": "Success",
  "data": [
    {
      "id": "contact_internal_123",
      "external_id": "user_123",
      "name": "John Doe",
      "email": "john@example.com",
      "custom_attributes": { "department": "Sales" },
      "created_at": 1704067200,
      "updated_at": 1704153600
    }
  ]
}

Errors: 409 when an external_id or email already exists.

Related