Rate this page:

TwiML™ Voice: <Room>

Programmable Video Rooms are represented in TwiML through the <Room> noun, which you can specify while using the <Connect> verb.

The <Room> noun allows you to connect to a named Programmable Video Room and talk with other participants who are connected to that Room.

Note that only Group Rooms support PSTN Participants.

To connect a Programmable Voice call to a Room, use the <Room> noun and provide the UniqueName for the Room you would like to connect to. If an in-progress Video Room with that unique name does not exist for your account, Twilio will move to the next set of TwiML instructions you have provided, or disconnect the call if the <Room> is the final TwiML instruction.

<Room> and <Connect> usage examples

<?xml version="1.0" encoding="UTF-8"?>

Ensure, your room type is group. Connecting voice calls to a Peer-to-Peer Room is not possible.


        Set the Participant's identity

        You can set a unique identity on the incoming caller using an optional property called participantIdentity.

        If you don't set the participantIdentity, then Twilio will assign a unique string value to the Participant's identity.

        <?xml version="1.0" encoding="UTF-8"?>
            <Room participantIdentity='alice'>DailyStandup</Room>

              Visit the Programmable Video documentation for more information about adding PSTN participants to Video Rooms.

              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 Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.


                    Thank you for your feedback!

                    Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

                    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