Produktionsklar mobil infrastrukturHTTPS API · Android & iOS · Dokumenterad slutänd för att avslutaUtforska plattformen
PLATFORMAPI-första arkitekturSäker enhet parningLeverans synlighetMulti-device kontrollVersioned dokumentation
Utvecklare hub/E-post 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.

Börja här

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.

Autentisering

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.

POSTA

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.

Parametrar

NameTypeRequirementBeskrivning
apikey string Nödvändig Your account API key.
apikeybox string Nödvändig API key of the configured mailbox.
sender_name string Nödvändig Display name of the sender.
sender_email e-post Nödvändig Sender email address.
recipient_email e-post Nödvändig Recipient address.
mail_subject string Nödvändig Email subject.
mail_body string Nödvändig Plain text or HTML body.
allow_self_signed yes | no Nödvändig 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-post Optional First optional CC recipient.
email_cc2 e-post Optional Second optional CC recipient.
email_cc3 e-post Optional Third optional CC recipient.
attachmentBase64 base64 Optional Base64-kodat bilagans innehåll.
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-post Optional Reply-to address.

Request example

ringla
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.

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.

Parametrar

NameTypeRequirementBeskrivning
apikey string Nödvändig Your account API key.
apikeybox string Nödvändig Mailbox API key.
mbox string Nödvändig Mailbox folder, for example INBOX.
start integer Nödvändig Starting index; use 0 for the first page.

Request example

ringla
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.

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.

Parametrar

NameTypeRequirementBeskrivning
apikey string Nödvändig Your account API key.
apikeybox string Nödvändig Mailbox API key.
email e-post Optional Filter one contact. An empty result means no unsubscribe record was found.

Request example

ringla
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.

Felsökning

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.

HTTPKodkodWhat 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 →