Receive MMS with Webhooks & API

Follow this step-by-step guide to learn how to receive MMS on an MMS-capable Notifyre number using a lightweight webhook notification and a follow-up API call to download the MMS content as Base64 for conversion to images.

⚠️ Before you start

  1. Ensure you have an MMS capable virtual SMS number (Standard SMS numbers cannot receive MMS).
  2. Create an API token in Developer → API Tokens (you’ll use x-api-token).

Step 1: Create a Webhook

  1. Go to Developer → Webhooks in your Notifyre dashboard.

  2. Click New

  3. Paste your HTTPS URL where you want to receive notifications.

  4. Select ‘MMS Received’ as the event type.

  5. Click Save.

✅ When an MMS arrives, Notifyre will send your endpoint a notification containing a ReplyId.

Step 2: Download the MMS Using the API

  1. Take the ReplyId received from your webhook.

  2. Make a GET request to the MMS Receive API to download the MMS:

GET https://api.notifyre.com/mms/received/<REPLY_ID>/download
Header: x-api-token: <YOUR_API_TOKEN>

Example using cURL:

curl --location "https://api.notifyre.com/mms/received/<REPLY_ID>/download" \
-H "x-api-token: <YOUR_API_TOKEN>"

The API response may contain the MMS content in Base64, which you can convert to an image file.


Tips

  • Start testing with .jpeg images to avoid Base64 viewer quirks with some formats.
  • Keep your API token secure; do not share publicly.
  • You can preview received MMS in Receive Activity Reports. Login to your Notifyre and navigate to Activity → Receive (filter Type = MMS).

General MMS Webhook FAQs 

Can I use an SMS number to receive MMS?

MMS messages require an MMS capable virtual SMS number. Standard SMS only numbers cannot receive MMS. To receive images, videos, or documents via Notifyre, make sure you purchase a number that supports MMS.

Which header do I use?

Use the x-api-token header to authenticate your API requests. Include your personal API token like this:

x-api-token: <YOUR_API_TOKEN>

This tells Notifyre that the request is coming from your account, ensuring secure access to download MMS content.

Why use a webhook to receive MMS?

  • Instant notifications: Get updates the moment an MMS or SMS reply is received—no delays.
  • Efficiency: Reduce unnecessary API calls and save resources.
  • Automation: Trigger workflows automatically (e.g., save media to storage, update a CRM, or send alerts).

Common SMS webhook use cases with Notifyre:

  • SMS Replies: Capture inbound SMS responses in real time to update ticketing systems or trigger follow-up actions.
  • MMS Received: When a customer sends an image or document, your webhook can capture the ReplyId and automatically download the file via the API.