Create a new sender of WhatsApp.
A Sender resource of WhatsApp.
Create a new sender of WhatsApp.
Body
Required
-
The ID of this Sender prefixed with the channel, e.g.,
whatsapp:E.164
-
Configuration settings for creating a sender, e.g., {"waba_id": "1234567890", "verification_method": "sms"}
-
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"}
-
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", "..."]}
POST
/v2/Channels/Senders
curl \
--request POST 'https://messaging.twilio.com/v2/Channels/Senders' \
--user "username:password" \
--header "Content-Type: application/json" \
--data '{"profile":{"name":"Example Profile Name","about":"This is an example about text.","emails":[{"email":"example@example.com","label":"Email"},{"email":"example2@example.com","label":"Email"}],"address":"123 Example St, Example City, EX 12345","logo_url":"https://logo_url.com","vertical":"Automotive","websites":[{"label":"Website","website":"https://website.com"},{"label":"Website","website":"http://website2.com"}],"description":"This is an example description."},"webhook":{"callback_url":"https://callback.com","fallback_url":"https://fallback.com","callback_method":"POST","fallback_method":"POST","status_callback_url":"https://statuscallback.com","status_callback_method":"POST"},"sender_id":"whatsapp:+999999999XX","configuration":{"waba_id":"1234567XXX","verification_method":"sms"}}'
Request example
{
"profile": {
"name": "Example Profile Name",
"about": "This is an example about text.",
"emails": [
{
"email": "example@example.com",
"label": "Email"
},
{
"email": "example2@example.com",
"label": "Email"
}
],
"address": "123 Example St, Example City, EX 12345",
"logo_url": "https://logo_url.com",
"vertical": "Automotive",
"websites": [
{
"label": "Website",
"website": "https://website.com"
},
{
"label": "Website",
"website": "http://website2.com"
}
],
"description": "This is an example description."
},
"webhook": {
"callback_url": "https://callback.com",
"fallback_url": "https://fallback.com",
"callback_method": "POST",
"fallback_method": "POST",
"status_callback_url": "https://statuscallback.com",
"status_callback_method": "POST"
},
"sender_id": "whatsapp:+999999999XX",
"configuration": {
"waba_id": "1234567XXX",
"verification_method": "sms"
}
}
Response examples (202)
{
"sid": "XEXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"status": "CREATING",
"profile": {
"name": "Example Profile Name",
"about": "This is an example about text.",
"emails": [
{
"email": "example@example.com",
"label": "Email"
},
{
"email": "example2@example.com",
"label": "Email"
}
],
"address": "123 Example St, Example City, EX 12345",
"logo_url": "https://logo_url.com",
"vertical": "Automotive",
"websites": [
{
"label": "Website",
"website": "https://website.com"
},
{
"label": "Website",
"website": "http://website2.com"
}
],
"description": "This is an example description."
},
"webhook": {
"callback_url": "https://callback.com",
"fallback_url": "https://fallback.com",
"callback_method": "POST",
"fallback_method": "POST",
"status_callback_url": "https://statuscallback.com",
"status_callback_method": "POST"
},
"sender_id": "whatsapp:+999999999XX",
"configuration": {
"waba_id": "1234567XXX",
"verification_code": null,
"verification_method": "sms",
"voice_application_sid": "APXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
}