Rate this page:

The Conversations API Overview

The Conversations API allows you to create conversational (back-and-forth) messaging across multiple channels: Chat, WhatsApp, and SMS.


All URLs in the reference documentation use the following base URL:

You can control your connectivity into Twilio’s platform by including your specific edge location in the subdomain. This will allow you to bring Twilio’s public or private network connectivity closer to your applications for improved performance.

For instance customers with infrastructure in Australia can make use of the sydney edge location by using the base url of:


This API uses HTTP Basic Authentication for authentication. Pass your Account SID as the username and Auth Token as the password (find them in the console).


The Conversation resource is the primary resource, representing a unique thread of a conversation.

A Conversation has the following sub-resources:

The Conversation Webhook resource covers webhook configurations for all Conversations.

Getting started

Refer to our quickstart guide for a step by step introduction to Conversations and an overview of commonly used features.

Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Community Forums or browsing the Twilio tag on Stack Overflow.


        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more