Conversations

Reply to a conversation

Send a text or email reply to the customer on an existing conversation, the same as clicking Send in the dashboard. The customer receives it. Reply only on a channel in the conversation’s channels. Website chats and calls with neither text nor email in channels cannot get a reply. The key’s creator must be allowed to message the customer in the dashboard. A customer who opted out by replying STOP gets no texts, but email still sends. The reply goes only to the conversation’s customer. The reply shows in the thread and Activity under the key’s creator. A failed send still returns 201 with delivery_status failed. Requests from this playground go to production and message a real customer. Customer API.

POST

conversations

{conversation_id}

messages

Reply to a conversation

curl --request POST \
  --url https://answeringagent.com/api/v1/conversations/{conversation_id}/messages \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "channel": "text",
  "body": "Hi Dana, your membership is cancelled and there is no charge on the 12th.",
  "idempotency_key": "cancel-confirm-184532"
}
'

import requests

url = "https://answeringagent.com/api/v1/conversations/{conversation_id}/messages"

payload = {
    "channel": "text",
    "body": "Hi Dana, your membership is cancelled and there is no charge on the 12th.",
    "idempotency_key": "cancel-confirm-184532"
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    channel: 'text',
    body: JSON.stringify('Hi Dana, your membership is cancelled and there is no charge on the 12th.'),
    idempotency_key: 'cancel-confirm-184532'
  })
};

fetch('https://answeringagent.com/api/v1/conversations/{conversation_id}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://answeringagent.com/api/v1/conversations/{conversation_id}/messages",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'channel' => 'text',
    'body' => 'Hi Dana, your membership is cancelled and there is no charge on the 12th.',
    'idempotency_key' => 'cancel-confirm-184532'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://answeringagent.com/api/v1/conversations/{conversation_id}/messages"

	payload := strings.NewReader("{\n  \"channel\": \"text\",\n  \"body\": \"Hi Dana, your membership is cancelled and there is no charge on the 12th.\",\n  \"idempotency_key\": \"cancel-confirm-184532\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://answeringagent.com/api/v1/conversations/{conversation_id}/messages")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"channel\": \"text\",\n  \"body\": \"Hi Dana, your membership is cancelled and there is no charge on the 12th.\",\n  \"idempotency_key\": \"cancel-confirm-184532\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://answeringagent.com/api/v1/conversations/{conversation_id}/messages")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"channel\": \"text\",\n  \"body\": \"Hi Dana, your membership is cancelled and there is no charge on the 12th.\",\n  \"idempotency_key\": \"cancel-confirm-184532\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": 7730514,
  "conversation_id": 184532,
  "from": "business",
  "channel": "text",
  "text": "Hi Dana, your membership is cancelled and there is no charge on the 12th.",
  "sent_at": "2026-10-06T15:04:52.000Z",
  "delivery_status": "queued",
  "error": null
}

{
  "error": "That conversation is not available.",
  "code": "not_found",
  "issues": [
    {
      "path": [
        "<unknown>"
      ],
      "message": "<string>"
    }
  ]
}

{
  "error": "That conversation is not available.",
  "code": "not_found",
  "issues": [
    {
      "path": [
        "<unknown>"
      ],
      "message": "<string>"
    }
  ]
}

{
  "error": "That conversation is not available.",
  "code": "not_found",
  "issues": [
    {
      "path": [
        "<unknown>"
      ],
      "message": "<string>"
    }
  ]
}

{
  "error": "That conversation is not available.",
  "code": "not_found",
  "issues": [
    {
      "path": [
        "<unknown>"
      ],
      "message": "<string>"
    }
  ]
}

{
  "error": "This endpoint accepts GET.",
  "code": "method_not_allowed"
}

{
  "error": "That conversation is not available.",
  "code": "not_found",
  "issues": [
    {
      "path": [
        "<unknown>"
      ],
      "message": "<string>"
    }
  ]
}

{
  "error": "That conversation is not available.",
  "code": "not_found",
  "issues": [
    {
      "path": [
        "<unknown>"
      ],
      "message": "<string>"
    }
  ]
}

{
  "error": "That conversation is not available.",
  "code": "not_found",
  "issues": [
    {
      "path": [
        "<unknown>"
      ],
      "message": "<string>"
    }
  ]
}

Authorizations

X-API-KEY

string

header

required

Headers

Idempotency-Key

string

The same as idempotency_key in the body. Send one or the other. Sending both returns 400.

Pattern: ^[A-Za-z0-9._:-]{1,120}$

Example:

"cancel-confirm-184532"

Path Parameters

conversation_id

integer

required

The conversation ID.

Required range: x >= 1

Body

application/json

body

string

required

The message, 1 to 5,000 characters after leading and trailing spaces are removed. An email reply uses the thread's subject. A text longer than 10 SMS segments returns 422.

Required string length: 1 - 5000

channel

enum<string>

One of the conversation's channels. Leave it out only when channels has exactly one of text and email.

Available options:

text,

email

idempotency_key

string

Scoped to the API key's creator and one conversation. A retry with the same idempotency key on the same conversation, from any API key that person created, returns the first message and sends nothing. Reusing the key with a different body or channel returns 409.

Pattern: ^[A-Za-z0-9._:-]{1,120}$

Response

The reply was accepted. Check delivery_status to see whether it went out. A retry with the same idempotency key returns the first message.

integer

required

Example:

7730514

conversation_id

integer

required

Example:

184532

from

enum<string>

required

Available options:

business

channel

enum<string>

required

Available options:

text,

email

Example:

"text"

text

string

required

Example:

"Hi Dana, your membership is cancelled and there is no charge on the 12th."

sent_at

string<date-time>

required

Example:

"2026-10-06T15:04:52.000Z"

delivery_status

enum<string>

required

queued means the carrier accepted the reply and has not sent it yet. failed means the send failed and error says why. unknown means the provider did not answer, so check the conversation later.

Available options:

queued,

sent,

delivered,

failed,

unknown

Example:

"queued"

error

string | null

required

A plain reason when the send failed. Otherwise null.

Example:

null

Reply to a conversation

curl --request POST \
  --url https://answeringagent.com/api/v1/conversations/{conversation_id}/messages \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "channel": "text",
  "body": "Hi Dana, your membership is cancelled and there is no charge on the 12th.",
  "idempotency_key": "cancel-confirm-184532"
}
'

import requests

url = "https://answeringagent.com/api/v1/conversations/{conversation_id}/messages"

payload = {
    "channel": "text",
    "body": "Hi Dana, your membership is cancelled and there is no charge on the 12th.",
    "idempotency_key": "cancel-confirm-184532"
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    channel: 'text',
    body: JSON.stringify('Hi Dana, your membership is cancelled and there is no charge on the 12th.'),
    idempotency_key: 'cancel-confirm-184532'
  })
};

fetch('https://answeringagent.com/api/v1/conversations/{conversation_id}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://answeringagent.com/api/v1/conversations/{conversation_id}/messages",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'channel' => 'text',
    'body' => 'Hi Dana, your membership is cancelled and there is no charge on the 12th.',
    'idempotency_key' => 'cancel-confirm-184532'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://answeringagent.com/api/v1/conversations/{conversation_id}/messages"

	payload := strings.NewReader("{\n  \"channel\": \"text\",\n  \"body\": \"Hi Dana, your membership is cancelled and there is no charge on the 12th.\",\n  \"idempotency_key\": \"cancel-confirm-184532\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://answeringagent.com/api/v1/conversations/{conversation_id}/messages")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"channel\": \"text\",\n  \"body\": \"Hi Dana, your membership is cancelled and there is no charge on the 12th.\",\n  \"idempotency_key\": \"cancel-confirm-184532\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://answeringagent.com/api/v1/conversations/{conversation_id}/messages")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"channel\": \"text\",\n  \"body\": \"Hi Dana, your membership is cancelled and there is no charge on the 12th.\",\n  \"idempotency_key\": \"cancel-confirm-184532\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": 7730514,
  "conversation_id": 184532,
  "from": "business",
  "channel": "text",
  "text": "Hi Dana, your membership is cancelled and there is no charge on the 12th.",
  "sent_at": "2026-10-06T15:04:52.000Z",
  "delivery_status": "queued",
  "error": null
}

{
  "error": "That conversation is not available.",
  "code": "not_found",
  "issues": [
    {
      "path": [
        "<unknown>"
      ],
      "message": "<string>"
    }
  ]
}

{
  "error": "That conversation is not available.",
  "code": "not_found",
  "issues": [
    {
      "path": [
        "<unknown>"
      ],
      "message": "<string>"
    }
  ]
}

{
  "error": "That conversation is not available.",
  "code": "not_found",
  "issues": [
    {
      "path": [
        "<unknown>"
      ],
      "message": "<string>"
    }
  ]
}

{
  "error": "That conversation is not available.",
  "code": "not_found",
  "issues": [
    {
      "path": [
        "<unknown>"
      ],
      "message": "<string>"
    }
  ]
}

{
  "error": "This endpoint accepts GET.",
  "code": "method_not_allowed"
}

{
  "error": "That conversation is not available.",
  "code": "not_found",
  "issues": [
    {
      "path": [
        "<unknown>"
      ],
      "message": "<string>"
    }
  ]
}

{
  "error": "That conversation is not available.",
  "code": "not_found",
  "issues": [
    {
      "path": [
        "<unknown>"
      ],
      "message": "<string>"
    }
  ]
}

{
  "error": "That conversation is not available.",
  "code": "not_found",
  "issues": [
    {
      "path": [
        "<unknown>"
      ],
      "message": "<string>"
    }
  ]
}

Get started

Endpoints

Webhooks

Guides

API playground

Reply to a conversation

Authorizations

Headers

Path Parameters

Body

Response