← All tutorialsMarketing

MMS promo blast

Send an image + short copy via MMS to an opted-in list. Per-recipient idempotency keys keep retries safe.

Cost~$0.02 per recipient
Operations
mms.send

Prerequisites

  • Twilio number with MMS capability enabled in /admin.
  • Opted-in recipient list in your DB (TCPA is your problem, not ours).

Walkthrough

1. Send an MMS

One call per recipient. `media_url` must be a public HTTPS URL Twilio can fetch.

bash# One MMS per recipient with a per-recipient idempotency key.
curl -X POST https://www.upivia.com/v1/service-requests \
  -H "Authorization: Bearer $AGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service":"mms",
    "operation":"send",
    "payload":{
      "to":"+15555550123",
      "from":"+15555550000",
      "body":"Spring sale - 20% off, code SPRING",
      "media_url":"https://cdn.example.com/promo.jpg"
    },
    "idempotency_key":"mms_spring_2026_+15555550123"
  }'

2. Throttle the storm

Set dailyRequestLimit on the agent so a buggy loop caps out at `blocked / daily_limit_exceeded` instead of draining $200 in 10 minutes.

Next steps

Audit every call at /audit-logs, watch spend at /usage, and tune budgets per service on the agent's page.

Create an account →