Close mobile menu
HomeSMSWhatsAppVoice CallingVoice MessagingConversationsBetaNumbersBetaVerifyReportingBetaHLRContactsGroupsLookupBalanceMMS

Send your first WhatsApp Message

In this WhatsApp Business API Quickstart, you'll learn how to send a new WhatsApp message to a WhatsApp user using Programmable Conversations.

Step 1: Request Early Access

To start testing MessageBird's WhatsApp Business API using Programmable Conversations, you need to first request and be granted early access.

Before we get started, make sure you've read and completed all steps in our Getting Started with WhatsApp Quickstart.

Step 2: Send your first WhatsApp message

First, you need to collect your live API key from the MessageBird Developer Dashboard and your Channel-ID from your Channel Directory.

Let's now enter your credentials, WhatsApp Channel-ID, and mobile number to the code snippet below:

curl -X "POST" "https://conversations.messagebird.com/v1/send" \\
-H "Authorization: AccessKey YOUR-API-KEY" \\
-H "Content-Type: application/json" \\
--data '{ "to":"+31XXXXXXXXX", "from":"WHATSAPP-CHANNEL-ID", "type":"text", "content":{ "text":"Hello!" }, "reportUrl":"https://example.com/reports" }'

Once your credentials are entered, go ahead and copy the above snippet to your terminal and hit enter!

Step 3: View the response

Now, let's view the MessageBird’s HTTP response to your API call. If the set up was correct, you'll receive a response similar to this:

{
"id": "24500a370c86916fe8aef77e4c24b6a6",
"status": "accepted",
"fallback": null
}

If something went wrong, you’ll receive an error response from the MessageBird API. Don't worry, simply head over to Troubleshooting WhatsApp to understand the error.

Congrats! You can now send WhatsApp messages with Programmable Conversations using cURL.

Next steps

You may now want to check out these resources:

Questions?

We’re always happy to help with code or other questions you might have! Check out our API Reference, Developer Tutorials, or contact our Support team.

Cookie Settings