---
title: "TeXML Refer Status"
method: POST
path: "TexmlReferStatusWebhook"
tags: ["Callbacks"]
---

# TeXML Refer Status

`POST TexmlReferStatusWebhook` (webhook)

Webhook sent for SIP REFER status updates.
This webhook uses Telnyx headers (telnyx-timestamp, telnyx-signature-ed25519) that are compatible with Standard Webhooks specification for SDK generation. Custom validation logic can map these to standard webhook-timestamp and webhook-signature equivalents. See https://github.com/standard-webhooks/standard-webhooks for details.

## Headers

- `telnyx-timestamp` integer, required: Unix timestamp for replay attack prevention
- `telnyx-signature-ed25519` string, required: Ed25519 signature of timestamp|payload for verification

## Payload `application/x-www-form-urlencoded`

- TexmlReferStatusWebhookSchema: Webhook sent for SIP REFER status updates.
  - `AccountSid` string, required: The unique identifier of the account (user_id).
  - `CallSid` string, required: The unique identifier of the call (call_control_id).
  - `CallSidLegacy` string, required: Legacy call identifier, same as CallSid.
  - `NotifySipResponseCode` string: The SIP response code from the NOTIFY message (conditional, only present on success).
  - `ReferCallStatus` 'failed' | 'in-progress' | 'busy' | 'canceled', required: The status of the SIP REFER operation.
  - `ReferSipResponseCode` string: The SIP response code from the REFER message (conditional, only present on success).
  - `Timestamp` string, date-time, required: The timestamp when the event occurred.

## Acknowledgement `200`

The server must return an HTTP 200, otherwise we will reattempt delivery at the failover webhook URL.

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)