The sendsavedmms action

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

The sendsavedmms action sends a previously saved MMS template to a single mobile number. The request must include a valid mms-id that exists under the same account/API key.

The sender number must be provisioned for the account and authorized for MMS. Optional group-display recipients may be included through to-displayonly.

Endpoint and headers

POST https://api.ci.mblox.com/ep/v2/
Content-Type: application/json; charset=utf-8
x-api-key: YOUR_API_KEY_HERE

Request parameters

custom-slides parameters

custom-slides can be used to replace the text on one or more slides in the saved template at send time. This is supported for replacing slide text, not for unsupported dynamic personalization or merge tag behavior.

Fallback SMS considerations

If an MMS is too large to deliver or if a carrier does not support MMS delivery, the API may deliver the content as fallback SMS if enabled. Fallback SMS consists of fallback-sms-text and, by default, a link to view the MMS content.

Group messaging with to-displayonly

Group messaging or group chat display behavior is supported by using the to-displayonly field. The field contains a comma-separated list of phone numbers with country code.

Special considerations

• Always submit destination and sender numbers in international number format. Include the country code and phone number. Do not include dialing prefixes such as 00 or 001 and do not include the plus sign.
• The mms-id must exist under the same account/API key.
• custom-slides only replaces text on saved template slides. It does not provide dynamic image, contact, calendar, or merge tag behavior.
• Line breaks are supported in custom-message-text.

Example: Send saved MMS without group messaging

curl -i -X POST \
  https://api.ci.mblox.com/ep/v2/ \
  -H 'Content-Type: application/json; charset=utf-8' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d '{
    "action": "sendsavedmms",
    "mms-id": "123456",
    "service-id": "campaign-123",
    "to": "17745550001",
    "from": "18885551234",
    "fallback-sms-text": "We could not deliver the MMS. View it here:",
    "disable-fallback-sms": false,
    "client-reference": "send-001"
  }'

Example: Send saved MMS with group messaging display

curl -i -X POST \
  https://api.ci.mblox.com/ep/v2/ \
  -H 'Content-Type: application/json; charset=utf-8' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d '{
    "action": "sendsavedmms",
    "mms-id": "123456",
    "service-id": "campaign-123",
    "to": "17745550001",
    "to-displayonly": "17745550002,17745550003",
    "from": "18885551234",
    "fallback-sms-text": "We could not deliver the MMS. View it here:",
    "disable-fallback-sms": false,
    "client-reference": "group-send-001"
  }'

Example: Send saved MMS with custom-slides

curl -i -X POST \
  https://api.ci.mblox.com/ep/v2/ \
  -H 'Content-Type: application/json; charset=utf-8' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d '{
    "action": "sendsavedmms",
    "mms-id": "123456",
    "service-id": "campaign-123",
    "to": "17745550001",
    "from": "18885551234",
    "client-reference": "custom-slide-001",
    "custom-slides": [
      {
        "custom-slide": "1",
        "custom-message-text": "Reminder: your appointment is tomorrow at 2 PM."
      }
    ]
  }'

Success response example

{
  "status": "success",
  "mms-id": "123456",
  "tracking-id": "abc123xyz",
  "to": "17745550001",
  "from": "18885551234",
  "status-details": "MMS request accepted and queued for delivery."
}

Failure response example

{
  "status": "failure",
  "error-code": "E241",
  "error-info": "Invalid MMS ID or MMS does not exist."
}

Response schema