Tuotantovalmis liikkuva infrastruktuuriHTTPS API · Android & iOS · Dokumentoitu pää loppuunTutustu alustaan
SMSMobileAPISMSMobileAPILiikkuvan infrastruktuurin rakentaminen
KojelautaLuo ilmainen tili
ILMA-AINEISTOAPI-ensimmäinen arkkitehtuuriTurvallisen laitteen paritusToimituksen näkyvyysMonilaiteohjausVersioasiakirjat
Kehittäjän solmupiste/Sähköposti 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.

Aloita tästä.

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.

Todennus

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.

LÄHETTÄÄ

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.

Parametrit

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

Request example

kiemura
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.
SAADA

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.

Parametrit

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

Request example

kiemura
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.
SAADA

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.

Parametrit

NimiTyyppiRequirementKuvaus
apikey jono Pakollinen Your account API key.
apikeybox jono Pakollinen Mailbox API key.
email sähköposti Valinnainen Filter one contact. An empty result means no unsubscribe record was found.

Request example

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

Vianetsintä

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.

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

Tarvitsetko apua?

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 →