Create conversation - WotNot

curl --request POST \
  --url https://api.wotnot.io/v1/conversations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "channel": "WHATSAPP",
  "from": "1123123123",
  "to": {
    "phone": "11231231230",
    "name": "John Doe",
    "email": "example@domain.com"
  },
  "message": {
    "type": "template",
    "data": {
      "template": "test_template",
      "parameters": {
        "header": [
          "John"
        ],
        "body": [
          "Doe",
          "Doe2"
        ],
        "buttons": {
          "copy_code": "123456",
          "otp": "123456",
          "url": "any"
        }
      },
      "variables": {
        "name": "John Doe"
      }
    }
  },
  "assignee": "agent_email@domain.com"
}
'

{
  "ok": true,
  "conversation": {
    "id": "12wfegrgt4t",
    "message_id": "sdvgret4353b",
    "created_at": "",
    "assignee": {
      "id": 123,
      "to": "agent_email@domain.com"
    }
  },
  "contact": {
    "id": "11111111",
    "name": "John Doe",
    "phone": "1234567890",
    "email": "example@domain.com"
  }
}

POST

/

v1

/

conversations

curl --request POST \
  --url https://api.wotnot.io/v1/conversations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "channel": "WHATSAPP",
  "from": "1123123123",
  "to": {
    "phone": "11231231230",
    "name": "John Doe",
    "email": "example@domain.com"
  },
  "message": {
    "type": "template",
    "data": {
      "template": "test_template",
      "parameters": {
        "header": [
          "John"
        ],
        "body": [
          "Doe",
          "Doe2"
        ],
        "buttons": {
          "copy_code": "123456",
          "otp": "123456",
          "url": "any"
        }
      },
      "variables": {
        "name": "John Doe"
      }
    }
  },
  "assignee": "agent_email@domain.com"
}
'

{
  "ok": true,
  "conversation": {
    "id": "12wfegrgt4t",
    "message_id": "sdvgret4353b",
    "created_at": "",
    "assignee": {
      "id": 123,
      "to": "agent_email@domain.com"
    }
  },
  "contact": {
    "id": "11111111",
    "name": "John Doe",
    "phone": "1234567890",
    "email": "example@domain.com"
  }
}

Authorizations

Authorization

string

header

required

All of WotNot's APIs use Bearer token authentication. Send your account token as Bearer <token>. You can find it in Settings > Account Settings > Developer. Keep it on your server: anyone who has it can call the API as your account.

Body

application/json

The message to send. Its shape depends on the channel, so pick WhatsApp or SMS.

WhatsApp
SMS

Start a conversation on WhatsApp by sending a template message.

channel

enum<string>

required

Set to WHATSAPP.

Available options:

WHATSAPP

Example:

"WHATSAPP"

from

string

required

The WhatsApp phone number to send from. It must be configured in your WotNot account.

Example:

"1123123123"

to

object

required

The contact to start the conversation with.

Show child attributes

message

object

required

The message to send.

Show child attributes

assignee

string

required

The email address of the teammate to assign the conversation to.

Example:

"agent_email@domain.com"

Response

Returns ok set to true, the new conversation, and the contact it's with.

ok

boolean

required

true when the request worked. Errors return false.

Example:

true

conversation

object

required

The new conversation.

Show child attributes

contact

object

required

The contact the conversation is with.

Show child attributes

Last modified on October 22, 2026