---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/api/errors/90040#article
headline: "90040: Broadcast 'MediaUrls' list has too many items"
url: https://www.twilio.com/docs/api/errors/90040
inLanguage: en
dateModified: 2026-06-08T11:38:30.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# 90040: Broadcast 'MediaUrls' list has too many items

Log Type: APPLICATION

Log Level: ERROR

## Description

This error occurs when your broadcast request includes more `MediaUrl` values than Twilio accepts. In Notify, SMS channel-specific media is sent in the `sms.media_urls` JSON array, and Twilio supports up to 10 media files per message.

### Possible causes

* Your request includes more than the supported number of `MediaUrl` values for a single message.
* Your `sms.media_urls` JSON array contains too many items.
* Your application repeats `MediaUrl` fields or appends media URLs dynamically without enforcing the per-message media limit before sending the request.

### Possible solutions

* Reduce the number of `MediaUrl` values in the request so the message includes no more than 10 media files.
* If you are using Notify channel-specific payloads, place media in the `sms.media_urls` JSON array.
* Validate the final media count in your application before you submit the broadcast request.
* Verify that the combined size of the message and its media stays within the destination channel limit before you retry the request.
* If you are starting a new implementation for SMS notifications, use Programmable Messaging for SMS notifications because Notify is deprecated and no longer supported.

#### Additional resources

* [Notification resource](/docs/notify/api/notification-resource)
* [Media subresource](/docs/messaging/api/media-resource)
* [Accepted content types for media](/docs/messaging/guides/accepted-mime-types)
