Productie-ready mobiele infrastructuurHTTPS API · Android & iOS · Gedocumenteerd einde tot eindeHet platform verkennen
SMSMobieleAPISMSMobieleAPIMobiele infrastructuur, verbonden
DashboardGratis account aanmaken
PLATFORMAPI-eerste architectuurBeveiligde apparaat koppelingZichtbaarheid van de leveringMulti-apparaatbesturingVersiede documentatie
Ontwikkelaarshub/E-mail API

MAIL · 3 documented operations

Email API documentation

Send email without sharing mailbox passwords, retrieve mailbox content and check unsubscribe status.

Connected email and messaging channels synchronized through the cloud
REST base URLhttps://api.smsmobileapi.com

JSON responses · HTTPS required · UTF-8

Connect your API key

Connect once, then test endpoints across SMS, calls, notifications, WhatsApp and email.

Start hier

Your first request in four steps

1

Configure a mailbox in the dashboard.

2

Copy both apikey and the mailbox apikeybox.

3

Send a simple text email first.

4

Add attachments or embedded images only after the basic request works.

Authenticatie

Keep credentials on your server

Email endpoints require the account apikey and the mailbox-specific apikeybox. Store both credentials server-side and mask them in application logs.

NA

Send an email

#
ENDPOINThttps://api.smsmobileapi.com/sendemail/

Sends plain-text or HTML email through a configured mailbox.

When to use it

Use it for transactional or operational email from your application.

Parameters

NameTypeRequirementBeschrijving
apikey string Vereist Your account API key.
apikeybox string Vereist API key of the configured mailbox.
sender_name string Vereist Display name of the sender.
sender_email e-mail Vereist Sender email address.
recipient_email e-mail Vereist Recipient address.
mail_subject string Vereist Email subject.
mail_body string Vereist Plain text or HTML body.
allow_self_signed yes | no Vereist Set to yes only when the configured mail server uses a trusted internal self-signed certificate.
unsubscribe 1 Optional Adds unsubscribe terms and a link.
email_cc1 e-mail Optional First optional CC recipient.
email_cc2 e-mail Optional Second optional CC recipient.
email_cc3 e-mail Optional Third optional CC recipient.
attachmentBase64 base64 Optional Base64-gecodeerde bijlage-inhoud.
charset string Optional Character set; default UTF-8.
embeddedImage HTTPS URL Optional Image to embed in the email.
embeddedImage_cid string Optional Content-ID referenced from the HTML body.
format string Optional Requested response format.
reply_name string Optional Reply-to display name.
reply_email e-mail Optional Reply-to address.

Request example

krul
curl -X POST "https://api.smsmobileapi.com/sendemail/" \
  -d "apikey=YOUR_API_KEY" \
  -d "apikeybox=YOUR_MAILBOX_KEY" \
  --data-urlencode "sender_name=Example Team" \
  -d "sender_email=team@example.com" \
  -d "recipient_email=customer@example.net" \
  --data-urlencode "mail_subject=Order confirmation" \
  --data-urlencode "mail_body=Your order has been confirmed." \
  -d "allow_self_signed=no"

Want to run this request? Connect your API key at the top of the page to unlock the interactive tester.

Connect key ↑
Good to know
  • Prefer POST because email bodies can be long.
  • Base64 attachments can make requests large; apply sensible size limits in your application.
KRIJGEN

Retrieve emails

#
ENDPOINThttps://api.smsmobileapi.com/getemail/

Retrieves messages from a configured mailbox folder.

When to use it

Use it to synchronize inbound email into a help desk or application workflow.

Parameters

NameTypeRequirementBeschrijving
apikey string Vereist Your account API key.
apikeybox string Vereist Mailbox API key.
mbox string Vereist Mailbox folder, for example INBOX.
start integer Vereist Starting index; use 0 for the first page.

Request example

krul
curl "https://api.smsmobileapi.com/getemail/?apikey=YOUR_API_KEY&apikeybox=YOUR_MAILBOX_KEY&mbox=INBOX&start=0"

Want to run this request? Connect your API key at the top of the page to unlock the interactive tester.

Connect key ↑
Good to know
  • Responses include available subject, sender, recipient, body, timestamp and attachment details.
KRIJGEN

Check unsubscribed contacts

#
ENDPOINThttps://api.smsmobileapi.com/email/unsubscribed/

Checks unsubscribe records generated by emails sent through the platform.

When to use it

Use it before sending campaigns and when synchronizing suppression lists.

Parameters

NameTypeRequirementBeschrijving
apikey string Vereist Your account API key.
apikeybox string Vereist Mailbox API key.
email e-mail Optional Filter one contact. An empty result means no unsubscribe record was found.

Request example

krul
curl "https://api.smsmobileapi.com/email/unsubscribed/?apikey=YOUR_API_KEY&apikeybox=YOUR_MAILBOX_KEY&email=customer@example.net"

Want to run this request? Connect your API key at the top of the page to unlock the interactive tester.

Connect key ↑
Good to know
  • Keep your own recipient database synchronized with unsubscribe results.
  • You remain responsible for applicable anti-spam and privacy rules.

Problemen oplossen

Errors and safe retries

Read the HTTP status and the JSON error field before retrying. Do not retry validation or authentication failures without correcting the request first.

HTTPRubriekWhat to do
400missing_parameterA required parameter is empty or absent. Check the parameter table for the endpoint.
403invalid_apikeyThe API key is unknown, expired or not authorized for the requested feature.
429too_many_requestsRequests are arriving too quickly. Wait, then retry with exponential backoff.
500server_errorThe service could not complete the request. Keep the response and contact support if it persists.
Retry ruleRetry only transient 429 and 5xx responses. Start after 1 second, then back off to 2, 4 and 8 seconds.

Need help?

Bring the request context—not your secrets.

Share the endpoint, timestamp, HTTP status and sanitized response. Never include API keys, tokens or private message content.

Contact API support →