Receive an MMS

Configuration

Set the parameter mms_url on your MMS-enabled Virtual Phone Number to https://yourapp.example/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.example/elks/mms

Example payload

direction=incoming&
id=sf8425555e5d8db61dda7a7b3f1b91bdb&
from=%2B46706861004&to=%2B46706860000&
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.
image	URL to image. 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 at least 6 hours and at least 5 times per callback.

List of images
A list of four images will look like this:
image: "https://example.com/test.jpg"
image2: "https://example.com/test2.jpg"
image3: "https://example.com/test3.jpg"
image4: "https://example.com/test4.jpg"