Infrastrutture mobili già pro-produzioneHTTPS API · Android & iOS · Fine documentatoEsplora la piattaforma
SMSMobileAPISMSMobileAPIInfrastrutture mobili, collegate
Pannello di controlloCreare un account gratuito
PLATFORMAPI-prima architetturaAccoppiamento sicuro del dispositivoVisibilità della consegnaControllo multidispositivoDocumentazione del Versione
Mozzo di sviluppo/Email 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.

Inizia qui

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.

Autenticazione

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.

INVIARE

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.

Parametri

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

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.

Parametri

NomeTipoRequirementDescrizione
apikey corda Necessario Your account API key.
apikeybox corda Necessario Mailbox API key.
mbox corda Necessario Mailbox folder, for example INBOX.
start integer Necessario 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.
OTTENERE

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.

Parametri

NomeTipoRequirementDescrizione
apikey corda Necessario Your account API key.
apikeybox corda Necessario Mailbox API key.
email e-mail Opzionale 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.

Risoluzione dei problemi

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.

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

Hai bisogno di aiuto?

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 →