Update a specific sender information like OTP Code, Webhook, Profile information.

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://twilio.demo.bump-doc.com/doc/messaging_v2/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
"messaging_v2 MCP server": {
  "url": "https://twilio.demo.bump-doc.com/doc/messaging_v2/mcp"
}
Close
POST /v2/Channels/Senders/{Sid}

A Sender resource represents a messaging channel sender of WhatsApp.

Update a specific sender information like OTP Code, Webhook, Profile information.

Path parameters

  • Sid string Required

    A 34 character string that uniquely identifies this Sender.

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^XE[0-9a-fA-F]{32}$.

application/json

Body

  • configuration object | null

    Configuration settings for creating a sender, e.g., {"waba_id": "1234567890", "verification_method": "sms"}

    Hide configuration attributes Show configuration attributes object | null
    • waba_id string | null

      The ID of the WhatsApp Business Account to use for this sender.

    • verification_method string | null

      The method to use for verification. Either "sms" or "voice".

      Values are sms or voice. Default value is sms.

    • verification_code string | null

      The verification code to use for this sender.

    • voice_application_sid string | null

      The SID of the Twilio Voice application to use for this sender.

  • webhook object | null

    Webhook specific configurations, e.g., {"callback_url": "https://xxx", "callback_method": "POST", "fallback_url": "https://xxx", "fallback_method": "POST", "status_callback_url": "https://xxx", "status_callback_method": "POST"}

    Hide webhook attributes Show webhook attributes object | null
    • callback_url string | null

      The URL to send the webhook to.

    • callback_method string | null

      The HTTP method to use for the webhook. Either "POST" or "PUT".

      Values are POST or PUT.

    • fallback_url string | null

      The URL to send the fallback webhook to.

    • fallback_method string | null

      The HTTP method to use for the fallback webhook. Either "POST" or "PUT".

      Values are POST or PUT.

    • status_callback_url string | null

      The URL to send the status callback to.

    • status_callback_method string | null

      The HTTP method to use for the status callback.

  • profile object | null

    Sender profile specific configurations, e.g., {"name": "xxx", "about": "xxx", "address": "xxx", "description": "xxx", "emails": "xxx@xxx", "logo_url": "https://xxx", "vertical": "xxx", "websites": ["https://xxx", "..."]}

    Hide profile attributes Show profile attributes object | null
    • name string | null

      The name of the sender.

    • about string | null

      The about text of the sender.

    • address string | null

      The address of the sender.

    • description string | null

      The description of the sender.

    • emails

      The emails of the sender.

    • logo_url string | null

      The logo URL of the sender.

    • vertical string | null

      The vertical of the sender. Allowed values are:

      • "Automotive"
      • "Beauty, Spa and Salon"
      • "Clothing and Apparel"
      • "Education"
      • "Entertainment"
      • "Event Planning and Service"
      • "Finance and Banking"
      • "Food and Grocery"
      • "Public Service"
      • "Hotel and Lodging"
      • "Medical and Health"
      • "Non-profit"
      • "Professional Services"
      • "Shopping and Retail"
      • "Travel and Transportation"
      • "Restaurant"
      • "Other"
    • websites

      The websites of the sender.

Responses

  • 202 application/json

    Accepted

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    • T-Request-Id string
    Hide response attributes Show response attributes object
    • sid string | null

      A 34 character string that uniquely identifies this Sender.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^XE[0-9a-fA-F]{32}$.

    • status string

      The Status of this Sender. One of CREATING, ONLINE, OFFLINE, PENDING_VERIFICATION, VERIFYING or ONLINE:UPDATING.

      Values are CREATING, ONLINE, OFFLINE, PENDING_VERIFICATION, VERIFYING, ONLINE:UPDATING, or STUBBED.

    • sender_id string | null

      The ID of this Sender prefixed with the channel, e.g., whatsapp:E.164

    • configuration object | null

      Configuration settings for creating a sender, e.g., {"waba_id": "1234567890", "verification_method": "sms"}

      Hide configuration attributes Show configuration attributes object | null
      • waba_id string | null

        The ID of the WhatsApp Business Account to use for this sender.

      • verification_method string | null

        The method to use for verification. Either "sms" or "voice".

        Values are sms or voice. Default value is sms.

      • verification_code string | null

        The verification code to use for this sender.

      • voice_application_sid string | null

        The SID of the Twilio Voice application to use for this sender.

    • webhook object | null

      Webhook specific configurations, e.g., {"callback_url": "https://xxx", "callback_method": "POST", "fallback_url": "https://xxx", "fallback_method": "POST", "status_callback_url": "https://xxx", "status_callback_method": "POST"}

      Hide webhook attributes Show webhook attributes object | null
      • callback_url string | null

        The URL to send the webhook to.

      • callback_method string | null

        The HTTP method to use for the webhook. Either "POST" or "PUT".

        Values are POST or PUT.

      • fallback_url string | null

        The URL to send the fallback webhook to.

      • fallback_method string | null

        The HTTP method to use for the fallback webhook. Either "POST" or "PUT".

        Values are POST or PUT.

      • status_callback_url string | null

        The URL to send the status callback to.

      • status_callback_method string | null

        The HTTP method to use for the status callback.

    • profile object | null

      Sender profile specific configurations for create and update request, e.g., {"name": "xxx", "about": "xxx", "address": "xxx", "description": "xxx", "emails": [{"label": "email 1", "email": "xxx@xxx"}], "logo_url": "https://xxx", "vertical": "xxx", "websites": [{"label": "email 1", "website": "https://xxx"}]}

      Hide profile attributes Show profile attributes object | null
      • name string | null

        The name of the sender.

      • about string | null

        The about text of the sender.

      • address string | null

        The address of the sender.

      • description string | null

        The description of the sender.

      • emails array[object] | null

        The emails of the sender.

        Hide emails attributes Show emails attributes object
        • email string
        • label string
      • logo_url string | null

        The logo URL of the sender.

      • vertical string | null

        The vertical of the sender. Allowed values are:

        • "Automotive"
        • "Beauty, Spa and Salon"
        • "Clothing and Apparel"
        • "Education"
        • "Entertainment"
        • "Event Planning and Service"
        • "Finance and Banking"
        • "Food and Grocery"
        • "Public Service"
        • "Hotel and Lodging"
        • "Medical and Health"
        • "Non-profit"
        • "Professional Services"
        • "Shopping and Retail"
        • "Travel and Transportation"
        • "Restaurant"
        • "Other"
      • websites array[object] | null

        The websites of the sender.

        Hide websites attributes Show websites attributes object
        • website string
        • label string
    • properties object | null

      Sender specific additional properties, e.g., {"quality_rating": "HIGH", "messaging_limit": "10K Customers/24hr"}

      Hide properties attributes Show properties attributes object | null
      • quality_rating string | null

        The quality rating of the sender.

      • messaging_limit string | null

        The messaging limit of the sender.

    • offline_reasons array[object | null] | null

      Reasons why the sender is offline., e.g., [{"code": "21211400", "message": "Whatsapp business account is banned by provider {provider_name} | Credit line is assigned to another BSP", "more_info": "https://www.twilio.com/docs/errors/21211400"}]

      Hide offline_reasons attributes Show offline_reasons attributes object | null
      • code string | null

        The error code.

      • message string | null

        The error message.

      • more_info string(uri) | null

        The URL to get more information about the error.

    • url string(uri) | null

      The URL of this resource, relative to https://messaging.twilio.com.

POST /v2/Channels/Senders/{Sid}
curl \
 --request POST 'https://messaging.twilio.com/v2/Channels/Senders/{Sid}' \
 --user "username:password" \
 --header "Content-Type: application/json" \
 --data '{"configuration":{"verification_code":"123456","voice_application_sid":"APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"},"webhook":{"callback_url":"https://callback.com","callback_method":"POST","fallback_url":"https://fallback.com","fallback_method":"POST","status_callback_url":"https://statuscallback.com","status_callback_method":"POST"},"profile":{"name":"Example Business","about":"Example about text","address":"123 Example St, Example City, EX 12345","description":"Example description","logo_url":"https://logo_url.com","vertical":"Automotive","websites":[{"website":"https://example.com","label":"Website"},{"website":"http://example.org","label":"Website"}],"emails":[{"email":"email@email.com","label":"Email"}]}}'
Request example
{
  "configuration": {
    "verification_code": "123456",
    "voice_application_sid": "APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  },
  "webhook": {
    "callback_url": "https://callback.com",
    "callback_method": "POST",
    "fallback_url": "https://fallback.com",
    "fallback_method": "POST",
    "status_callback_url": "https://statuscallback.com",
    "status_callback_method": "POST"
  },
  "profile": {
    "name": "Example Business",
    "about": "Example about text",
    "address": "123 Example St, Example City, EX 12345",
    "description": "Example description",
    "logo_url": "https://logo_url.com",
    "vertical": "Automotive",
    "websites": [
      {
        "website": "https://example.com",
        "label": "Website"
      },
      {
        "website": "http://example.org",
        "label": "Website"
      }
    ],
    "emails": [
      {
        "email": "email@email.com",
        "label": "Email"
      }
    ]
  }
}
Response examples (202)
{
  "sid": "XEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "VERIFYING",
  "sender_id": "whatsapp:+999999999XX",
  "configuration": {
    "waba_id": "1234567XXX",
    "verification_method": "sms",
    "verification_code": null,
    "voice_application_sid": "APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  },
  "webhook": {
    "callback_url": "https://callback.com",
    "callback_method": "POST",
    "fallback_url": "https://fallback.com",
    "fallback_method": "POST",
    "status_callback_url": "https://statuscallback.com",
    "status_callback_method": "POST"
  },
  "profile": {
    "about": "Example about text",
    "address": "123 Example St, Example City, EX 12345",
    "description": "Example description",
    "emails": [
      {
        "email": "email@email.com",
        "label": "Email"
      }
    ],
    "name": "Example Business",
    "logo_url": "https://logo_url.com",
    "vertical": "Automotive",
    "websites": [
      {
        "website": "https://example.com",
        "label": "Website"
      },
      {
        "website": "http://example.org",
        "label": "Website"
      }
    ]
  }
}