v18

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-05-0672377.8 KB
MessagingV2ChannelsSender

Update a sender's information, including `profile`, `webhook`, and `configuration`.

(WhatsApp only) Update a Sender. You can update a sender's information, including profile, webhook, and configuration. To verify a phone number, set configuration.verification_code to the One-time Password (OTP) that you received.

post/v2/Channels/Senders/{Sid}

Path parameters

Sidstring required

The SID of the sender.

Request body

Example request

{
  "configuration": {
    "waba_id": "12345678912345",
    "verification_method": "sms"
  }
}

Response

Accepted

sidstring nullable

The SID of the sender.

status'CREATING' | 'ONLINE' | 'OFFLINE' | 'PENDING_VERIFICATION' | 'VERIFYING' | 'ONLINE:UPDATING' | 'TWILIO_REVIEW' | 'DRAFT' | 'STUBBED'

The status of the sender.

sender_idstring nullable

The ID of the sender in whatsapp:<E.164_PHONE_NUMBER> format.

urlstring uri nullable

The URL of the resource.

Example response

{
  "sender_id": "whatsapp:+15017122661",
  "configuration": {
    "waba_id": "12345678912345",
    "verification_method": "sms"
  },
  "properties": {
    "quality_rating": "HIGH",
    "messaging_limit": "10K Customers/24hr"
  },
  "compliance": {
    "countries": [
      {
        "country": "US"
      }
    ]
  }
}