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.

1. Sending Emails

Endpoint: 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:

- 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

2. Retrieving Emails

Endpoint: 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": ""
            }
        ]
    }
}

Contact Us

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