Send Email

POST

https://apis.mailcompose.com/apis/v1/send

This API will send a new fresh email.
Make sure that the email that you pass in from field is a registered email in the Mailcompose Dashboard.
To add a new sender

Click on Send Now

Click on Add a new Sender

Request

Header Params

Body Params application/json

Example

{
    "from": "invoices@yourcompany.com",
    "to": [
        "user@example.com"
    ],
    "cc": [
        "user@example.com"
    ],
    "bcc": [
        "user@example.com"
    ],
    "subject": "string",
    "text": "string",
    "html": "string",
    "attachments": [
        {
            "filename": "att1.jpg",
            "contentType": "image/jpeg",
            "base64": "iYQ..."
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://apis.mailcompose.com/apis/v1/send' \
--header 'Api-Key: xyz-xyz-xyz-xyz-xyz' \
--header 'Api-Secret: xyz-xyz-xyz-xyz-xyz' \
--header 'User-Agent: YourCompanyName' \
--header 'Content-Type: application/json' \
--data-raw '{
    "from": "invoices@yourcompany.com",
    "to": [
        "user@example.com"
    ],
    "cc": [
        "user@example.com"
    ],
    "bcc": [
        "user@example.com"
    ],
    "subject": "string",
    "text": "string",
    "html": "string",
    "attachments": [
        {
            "filename": "att1.jpg",
            "contentType": "image/jpeg",
            "base64": "iYQ..."
        }
    ]
}'

Responses

🟢200Success

application/json

Body

Example

{
    "success": true,
    "payload": {
        "messageId": "snmdkm2k3em2@sub.domain.com",
        "mailcomposeEmailId": "makcwi2d2w1212e",
        "threadId": "tsdvjne12e12pkm1pk"
    }
}

🟠402Free Plan Limit Exceeded

Modified at 2024-08-14 12:05:23

Receive Email Webhook