Settings
Create a new Setting
Creates an immutable webhook configuration.
Authentication: Inline vs Shared
Inline (Recommended):
- Credentials directly in Setting (source: INLINE)
- Use when: Each Setting has unique credentials
Shared (Advanced):
- Multiple Settings share one AuthProfile resource (source: REFERENCE)
- Use when: Centralizing credentials, managing one AuthProfile instead of duplicating across Settings
Immutability
Settings are immutable (except friendlyName, description).
To change configuration: Create new Setting → Update Rule → Delete old Setting.
This enables safe testing before production cutover.
post/v1/Webhooks/Settings
Request
- Base URLhttps://webhooks.twilio.com
- AuthHTTP basic
Headers
Idempotency-Keystring uuid
Idempotency key for mutation operations. Must be a UUIDv7 (other UUID versions are rejected with a 400).
Request body
Example request
{
"edgeZones": {
"zones": [
"eu",
"na"
]
}
}Response
Setting created
Example response
{
"edgeZones": {
"zones": [
"eu",
"na"
]
}
}Changes
No recorded changes to this operation across all 1 revision of this API.