Dev DOC Email - SMSMobileAPI

Email API Documentation

Welcome to the SMSMobileAPI email API documentation. This guide explains how to use our API to send and retrieve emails using HTTP requests.

SMSMobileAPI now allows you to connect any email account to our powerful API! Once the integration is set up via our intuitive dashboard (click here to log in or create an account), you’ll unlock seamless email sending and receiving through HTTP requests.

Secure Email Without Passwords

Send emails without needing the client's password. Use a secure API key for safe and easy access.

Easy Email Integration

Integrate email sending with simple HTTP requests. No complex coding required.

Retrieve Emails Easily

Fetch received emails via HTTP and manage them directly in your project.

Send Email

Endpoint: POST https://api.smsmobileapi.com/sendemail/

Required Parameters:

- apikey: Your unique API key for authentication.

- apikeybox: The API key linked to your email configuration.

- sender_name: Name of the email sender.

- sender_email: Email address of the sender.

- recipient_email: Email address of the recipient.

- mail_subject: Subject of the email.

- mail_body: Content of the email (HTML or plain text).

- allow_self_signed: Set to "yes" to allow self-signed certificates.

Optional Parameters:

- unsubscribe: value must be 1 to active it -> Automatically adds unsubscribe terms at the bottom of the email, along with an unsubscribe link.

- email_cc1, email_cc2, email_cc3: Additional email addresses to CC.

- attachmentBase64: Base64-encoded attachment content.

- charset: Character set for the email. Default is UTF-8.

- embeddedImage: The URL of the image to be embedded in the email.

- embeddedImage_cid: A unique Content-ID (CID) used to reference the embedded image in the email's HTML body.

- format: The format of the response.

- reply_name: The name of the reply sender.

- reply_email: The email address of the reply sender.

Example Request:


POST https://api.smsmobileapi.com/sendemail/?apikey=YOUR_API_KEY&apikeybox=YOUR_API_BOX&sender_name=John+Doe&sender_email=john@example.com&recipient_email=jane@example.com&mail_subject=Hello&mail_body=Hello+Jane%21

Did you know?
We also have a Python module that allows you to send your emails even more easily and securely! 🚀📧
https://pypi.org/project/smsmobileapi-send-email/

Retrieving Emails

Endpoint: GET https://api.smsmobileapi.com/getemail/

Required Parameters:

- apikey: Your unique API key for authentication.

- apikeybox: The API key linked to your email configuration.

- mbox: The folder from which to retrieve emails (e.g., INBOX).

- start: The starting index for email retrieval (default is 0).

Example Request:


GET https://api.smsmobileapi.com/getemail/?apikey=YOUR_API_KEY&apikeybox=YOUR_API_BOX&mbox=INBOX

Response:

The API returns a JSON response containing email details, including subject, sender, recipient, body, timestamp, and attachments (if available).


{


    "result": {

		
        "error": "0",

        "emaillist": [
            {

				
                "id": "12345",

                "object": "Welcome",

                "body": "Hello, welcome to our service!",

                "email1": "sender@example.com",

                "email2": "recipient@example.com",

                "timestamp": "1672531200",

                "date": "01/01/2023 - 12:00:00",

                "size": "15KB",

                "attachment": ""

				
            }
        ]

		
    }

	
}

Retrieve unsubscribed contacts

Endpoint: GET https://api.smsmobileapi.com/email/unsubscribed/

Required Parameters:

- apikey: Your unique API key for authentication.

- apikeybox: The API key linked to your email configuration.

- email: Email of the contact (If the response is empty, the contact is not unsubscribed. If a response exists for the email, then the email is unsubscribed)

Example Request:


GET https://api.smsmobileapi.com/email/unsubscribed/?apikey=YOUR_API_KEY&apikeybox=YOUR_API_BOX

Note :

This API allows you to automatically retrieve the list of contacts who have received an email through your mailing and have clicked the unsubscribe link or requested to no longer receive communications.

With this API, you can:

Identify contacts who asked to be removed from your mailing lists.
Keep your databases up to date in real-time.
Stay compliant with anti-spam regulations (such as GDPR or CAN-SPAM).

👉 Use this API to maintain clean lists and respect your recipients’ preferences.

Contact Us

If you have any questions or need further assistance, feel free to contact us at api@smsmobileapi.com.