Update Voice Webhook

put

https://www.fast2sms.com/dev/webhook/v2/voice/{id}

Update an existing webhook configuration for the Voice service.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

This endpoint updates an existing Voice webhook configuration by its id.

Path Params

string

required

The unique Webhook ID.

Body Params

name

string

required

Webhook Name - Friendly label for the webhook configuration

template

string

enum

required

Defaults to custom

Select Format - Webhook format to use. Voice has the Standard Webhook format ('custom').

Allowed:

event

string

enum

required

Defaults to all

Select Event - Which call results trigger the webhook.

Allowed:

method

string

enum

required

Defaults to POST

Method - HTTP method to invoke. (Locked when format is not Standard Webhook).

Allowed:

url

string

required

URL - Target endpoint URL to send payloads to.

content_type

string

enum

required

Defaults to application/json

Content-Type - Target encoding format for payload transmission. (Locked when format is not Standard Webhook).

Allowed:

payload_transform

string

enum

required

Defaults to standard

X-Payload-Transform - Payload transform type. Shown only when Content-Type is Form URL Encoded.

Allowed:

status

string

enum

required

Defaults to active

Webhook Status - Whether the webhook trigger is active (active/inactive).

Allowed:

payload

string

Body - Custom payload template structure (JSON/XML). Use dynamic placeholders like @{{request_id}}, @{{status}}, etc. (Locked when format is not Standard Webhook).

headers

object

Key-value pairs of custom headers to forward with the payload

payload_type

string

enum

required

Defaults to SIMPLIFIED

Payload formatting level

Allowed:

Headers

Authorization

string

required

Defaults to YOUR_API_KEY

Provide "YOUR_API_KEY".

Response

200

Webhook configuration updated successfully.

Language

Loading…

Response

Click Try It! to start a request and see the response here!