Numbers - Update MMS Settings
Enable or disable MMS (multimedia messaging) on a provisioned phone number. Use this to turn picture, video and group messaging on for a line, or to disable it while leaving SMS in place.
What this does: Sets the MMS feature flag on the line and returns the resulting state. SMS is unaffected either way — disabling MMS does not stop the line sending or receiving text messages.
Reading the response: MMS reflects the state of the line after the update (Enabled or Disabled). Check Status — Success means the change was applied; any other value means it was not, and StatusMessage carries the reason.
Next steps:
- Confirm the line’s current service state —
POST /v1.0/numbers/status - Review the account’s message routing —
GET /v1.0/message/routes
Body
The phone number to update, in E.164 format (e.g. +13156120726). Required.
"+13156120726"
Set to true to enable MMS on the number, or false to disable it. Required.
true
Account identifier (AID- prefix) that the number belongs to. Conditional — required for distributors whose Bearer token has access to more than one account, and optional otherwise.
"AID-eab92510-1040-45a5-bb9c-xxxx"
Response
Success — returns the line's MMS state after the update
The response is of type object.