Rate this page:

Thanks for rating this page!

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

Send to Flex

Send to Flex widget


For Flex-enabled Projects, Send to Flex transfers an incoming call or a message to Flex by creating a TaskRouter Task. Voice calls are enqueued and the caller will hear hold music while waiting for a Worker. Messages are transferred to Flex as new tasks for assignment to a Worker.

Required Configuration:

You must select a Workflow and Channel when configuring this Widget.




The name of the Flex Worfklow assigned to the Project.


The Task Channel being used. Only Voice and Chat are currently supported (select Chat for SMS, WhatsApp, Facebook or Line).

Optional Configuration:

You may optionally decide to declare task attributes, priority, timeout, and a hold music TwiML URL for the request initiated by this Widget. These




The priority of this task in the TaskQueue. Tasks with a higher priority are assigned before older tasks with a lower priority. If not specified, will be treated as 0 during evaluation.


The amount of time in seconds the task is allowed to live up to a maximum of 2 weeks. Defaults to 24 hours if not supplied.


JSON representing task attributes (max 1024 characters)

URL Method

Method to be used when requesting the Hold Music TwiML URL (GET or POST)

Hold Music TwiML URL

The URL for custom hold music TwiML. If not specified, the default hold music will play upon transfer.




Task Created

For Voice calls, transition is triggered when the Enqueue action URL is requested. For Messages, transition is triggered as soon as the TaskRouter Task is created.

Failed to Create Task

For Voice calls, transition is triggered if enqueuing of the call fails. For Messages, transition is triggered immediately when TaskRouter returns an error for Task creation.

Call Failed

Only applies to Voice calls. Transition is triggered if QueueResult is "system-error".

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