File Attachments and API Limits

This Twilio product is currently available as a Beta release. Some features are not yet implemented and others may be changed before the product is declared as Generally Available. Use of this Beta release is subject to the relevant terms of the applicable license agreement. Beta products are not covered by a Twilio SLA. Learn more about beta product support.

Flex Conversations requires Flex UI 2.0. If you are on Flex UI 1.x, please refer to Messaging in Flex pages.

File Attachments and API Limits

For enabling file attachments on your Flex account, see "How do I enable and configure file attachments?" in the Conversations FAQ and Troubleshooting page.

Address Type

Number of attachments

Max File Size (bytes)

Max Total File Size (bytes)

Accepted Extensions





"jpg", "jpeg", "png", "amr", "mp3", "mp4", "pdf", "heic", "txt", "gif"





"jpg", "jpeg", "png", "amr", "mp3", "mp4", "pdf", "heic"





"jpg", "jpeg", "png", "amr", "mp3", "mp4", "pdf", "heic", "oga"





"jpg", "jpeg", "png", "amr", "mp3", "mp4", "pdf", "heic", "txt", "gif"

Conversations API Limits

See Conversations Limits for a detailed list on length, media, and other limits.

Interactions Endpoint Limits

GET actions are not accessible for the API endpoints.

Due to various limitations and concerns, Flex Conversations will constrain certain actions.

Rate limits on API endpoints

The Interactions API has a limit of 20 requests per second per endpoint per account. The API returns an HTTP 429 status when rate limits are exceeded and should be handled accordingly on the customer side.

Webchats Endpoint Limits

The Flex Webchat orchestrator currently has a rate limit of 5 requests per second beyond which the customer can get throttled. When exceeded, the API returns an HTTP 429.

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