Receive an MMS

Configuration

Set the parameter mms_url on your MMS-enabled Virtual Phone Number to https://yourapp.io/elks/mms (or wherever your webhook code is). We'll make an HTTP POST (application/x-www-form-urlencoded) request to this URL every time your number receives an MMS.

Request

POST https://yourapp.io/elks/mms
Example payload
direction=incoming&
id=sf8425555e5d8db61dda7a7b3f1b91bdb&
from=%2B46706861004&to=%2B46706861020&
created=2018-07-13T13%3A57%3A23.741000&
message=Hello%20how%20are%20you%3F&
image=https%3A%2F%2Fapi.46elks.com%2Fa1%2F

Request parameters

Parameter Description
id The unique id of the message in our systems.
from The sender of the MMS.
to The phone number the MMS was sent to.
message The message included with the MMS.
images A list of URLs pointing to the MMS image(s). Only present if an image was sent.
created The time in UTC when the MMS object was created in our systems.

Response structure

Your webhook code must respond with a HTTP status in the range 200-204. If not, the API will consider the request failed and keep trying for up to 24 hours.