Skip to main content
GET
/
v1
/
sms
/
conversations
/
{conversationId}
/
webhook
Get Post Conversation Webhook
curl --request GET \
  --url https://api.bland.ai/v1/sms/conversations/{conversationId}/webhook \
  --header 'authorization: <authorization>'
{
  "data": {
    "conversation_id": "convo_abc123",
    "url": "https://example.com/sms-webhook",
    "payload": {
      "type": "status",
      "conversation_id": "convo_abc123",
      "status": "ended",
      "phone_number": "+15550001111",
      "agent_number": "+15550002222",
      "channel": "sms",
      "message_count": 5
    },
    "created_at": "2026-04-13T20:50:59.233Z",
    "user_id": "user_abc123",
    "metadata": [
      {
        "sent_at": "2026-04-13T20:50:59.000Z",
        "response_code": 200,
        "response_time": "142ms",
        "send_type": "spawn"
      }
    ]
  },
  "errors": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.bland.ai/llms.txt

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

Enterprise Feature - SMS is only available on Enterprise plans. Contact your Bland representative for access.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
conversationId
string
required
The unique ID of the conversation to retrieve webhook logs for.

​
Response

​
data
object
The webhook log for this conversation, or null if no webhook has been sent.
​
data.conversation_id
string
The conversation this webhook log belongs to.
​
data.url
string
The webhook URL that was called.
​
data.payload
object
The full webhook payload that was sent.
​
data.created_at
string
ISO timestamp for when the webhook log was created.
​
data.user_id
string
The organization ID that owns this conversation.
​
data.metadata
array
An array of delivery attempt records. Each entry contains:
  • sent_at — ISO timestamp of the delivery attempt
  • response_code — HTTP status code returned by your endpoint, or null if the request failed
  • response_time — how long the request took
  • send_type — delivery method (e.g. "spawn")
  • error_message — error details if the delivery failed
​
errors
null|array
null on success, or a list of error objects if a failure occurred.
{
  "data": {
    "conversation_id": "convo_abc123",
    "url": "https://example.com/sms-webhook",
    "payload": {
      "type": "status",
      "conversation_id": "convo_abc123",
      "status": "ended",
      "phone_number": "+15550001111",
      "agent_number": "+15550002222",
      "channel": "sms",
      "message_count": 5
    },
    "created_at": "2026-04-13T20:50:59.233Z",
    "user_id": "user_abc123",
    "metadata": [
      {
        "sent_at": "2026-04-13T20:50:59.000Z",
        "response_code": 200,
        "response_time": "142ms",
        "send_type": "spawn"
      }
    ]
  },
  "errors": null
}
Docs for agents: llms.txt