For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SDKsHelp CenterLog inSign up
    • Overview
  • Getting Started
    • API Mechanics
    • Quickstart
  • Guides
    • Communications API
    • Troubleshooting
    • Events
    • Changelog
  • Comms API Reference
      • Summary
      • POSTSend Messages
      • GETList Messages
      • GETFetch a Message
      • GETFetch a Message Operation
      • GETList Message Operations
      • GETSeek a Message by an Identifier
LogoLogo
SDKsHelp CenterLog inSign up
Comms API ReferenceMessages

Messages

POST
/v1/Messages
1curl -X POST 'https://comms.twilio.com/preview/Messages' \
2--header 'Content-Type: application/json' \
3--data '{
4    "to": [{
5        "address": "+12065551337",
6        "channel": "PHONE"
7    }],
8    "content": {
9        "text": "What day is it?"
10    }
11}'\
12-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN \
Try it
Was this page helpful?
Previous

Send Messages

Next
Built with

Use Messages to send and receive RCS, SMS & MMS, and WhatsApp messages.

Send with precise control over every aspect of your message or let Twilio share control and up-level your messaging with data-driven optimizations.

Messages supports:

Feature
Sending a Message to a single recipient
Sending Messages to many recipients in a single request
Sending to both stored Profiles and/or directly specified messaging addresses (e.g. phone number)
Sending Messages to Profiles with multiple communication addresses: Twilio will choose the best channel.
Sending Messages to stored Audiences with per-recipient content personalization
Sending Messages with templated content that reference traits of your stored Profiles
Sending Messages with rich content
Sending Messages scheduled for future delivery.
Receiving inbound Messages sent to your Twilio phone numbers.