Email API Documentation

Начни здесь

Your first request in four steps

Configure a mailbox in the dashboard.

Copy both apikey and the mailbox apikeybox.

Send a simple text email first.

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

Аутентификация

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.

ПОЧТА

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.

Параметры

Имя	Тип	Requirement	Описание
`apikey`	нить	Необходимый	Your account API key.
`apikeybox`	нить	Необходимый	API key of the configured mailbox.
`sender_name`	нить	Необходимый	Display name of the sender.
`sender_email`	электронная почта	Необходимый	Sender email address.
`recipient_email`	электронная почта	Необходимый	Recipient address.
`mail_subject`	нить	Необходимый	Email subject.
`mail_body`	нить	Необходимый	Plain text or HTML body.
`allow_self_signed`	yes \| no	Необходимый	Set to yes only when the configured mail server uses a trusted internal self-signed certificate.
`unsubscribe`	1	Необязательный	Adds unsubscribe terms and a link.
`email_cc1`	электронная почта	Необязательный	First optional CC recipient.
`email_cc2`	электронная почта	Необязательный	Second optional CC recipient.
`email_cc3`	электронная почта	Необязательный	Third optional CC recipient.
`attachmentBase64`	base64	Необязательный	Содержимое вложения, закодированное в Base64.
`charset`	нить	Необязательный	Character set; default UTF-8.
`embeddedImage`	HTTPS URL	Необязательный	Image to embed in the email.
`embeddedImage_cid`	нить	Необязательный	Content-ID referenced from the HTML body.
`format`	нить	Необязательный	Requested response format.
`reply_name`	нить	Необязательный	Reply-to display name.
`reply_email`	электронная почта	Необязательный	Reply-to address.

Request example

cURL

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.

Параметры

Имя	Тип	Requirement	Описание
`apikey`	нить	Необходимый	Your account API key.
`apikeybox`	нить	Необходимый	Mailbox API key.
`mbox`	нить	Необходимый	Mailbox folder, for example INBOX.
`start`	integer	Необходимый	Starting index; use 0 for the first page.

Request example

cURL

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.

Параметры

Имя	Тип	Requirement	Описание
`apikey`	нить	Необходимый	Your account API key.
`apikeybox`	нить	Необходимый	Mailbox API key.
`email`	электронная почта	Необязательный	Filter one contact. An empty result means no unsubscribe record was found.

Request example

cURL

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.

Поиск неисправностей

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.

HTTP	Код	What to do
400	`missing_parameter`	A required parameter is empty or absent. Check the parameter table for the endpoint.
403	`invalid_apikey`	The API key is unknown, expired or not authorized for the requested feature.
429	`too_many_requests`	Requests are arriving too quickly. Wait, then retry with exponential backoff.
500	`server_error`	The 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.

Нужна помощь?

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 →

Email API documentation

Your first request in four steps

Keep credentials on your server

Параметры

Request example

Параметры

Request example

Параметры

Request example

Errors and safe retries

Bring the request context—not your secrets.