Send Email

POST

/v2/onebox/send-email

Send an email from a specified mailbox account.

account accepts either a bare address or Name <address> for a per-message sender display name.

Scheduling: pass isScheduled: true together with a future scheduledAt to schedule the email instead of sending it now. The email is stored as a scheduled draft and sent by a background job at scheduledAt (delivery may be up to one minute later). The response is 202 with a draftId; use the drafts endpoints to view, edit or cancel it. The draft is deleted once sent. Passing draftId together with isScheduled converts that existing draft into a scheduled one. Requests without isScheduled behave exactly as before.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🟢202Accepted

🟠400Bad Request

🟠409

Request Example

Shell

JavaScript

Java

Swift

cURL

ExamplePer-message sender display nameSchedule for later

curl --location 'https://api.zapmail.ai/api/v2/onebox/send-email' \
--header 'x-auth-zapmail: YOUR_API_KEY' \
--header 'x-workspace-id: WORKSPACE_UUID' \
--header 'x-service-provider: GOOGLE' \
--header 'Content-Type: application/json' \
--data-raw '{
    "account": "sender@example.com",
    "to": "recipient@example.com",
    "subject": "Email Subject",
    "body": "Email body content",
    "cc": [
        "cc1@example.com",
        "cc2@example.com"
    ],
    "bcc": [
        "bcc1@example.com",
        "bcc2@example.com"
    ],
    "messageId": "message-id-for-reply",
    "threadId": "thread-id-for-reply"
}'

Response Example

200 - Success Example

{
    "success": true,
    "data": {
        "userId": "usr_8f42c1d7",
        "workspaceId": "ws_91a7e3b2",
        "account": "john.doe@example.com",
        "provider": "gmail",
        "serviceProvider": "google",
        "id": "account:john.doe@example.com",
        "threadId": "thread_7a91bc42",
        "messageId": "<msg_9d83f1a2@example.com>",
        "headers": {
            "Received": "from mail.example.com by mx.google.com",
            "From": "John Doe <john.doe@example.com>",
            "To": "jane.smith@example.com",
            "Cc": "team@example.com",
            "Bcc": "",
            "Subject": "Project Update - September 2026",
            "MIME-Version": "1.0",
            "Content-Type": "text/html; charset=UTF-8",
            "Date": "Wed, 9 Sep 2026 17:37:00 +0530",
            "Message-Id": "<msg_9d83f1a2@example.com>"
        },
        "subject": "Project Update - September 2026",
        "snippet": "Hi Jane, sharing a quick update on the project and the next steps.",
        "date": "2026-09-09T12:07:00.000Z",
        "size": 546,
        "labels": [
            "SENT"
        ],
        "from": [
            {
                "name": "John Doe",
                "address": "john.doe@example.com"
            }
        ],
        "to": [
            {
                "address": "jane.smith@example.com"
            }
        ],
        "body": {
            "html": "<p>Hi Jane,</p><p>Sharing a quick update on the project and the next steps.</p><p>Thanks,<br>John</p>"
        },
        "hasAttachments": false,
        "isRead": true,
        "isStarred": false,
        "isDraft": false,
        "isDeleted": false,
        "isSent": true,
        "isWarmUp": false,
        "isDmarc": false,
        "folderPath": "sent",
        "aiStatus": "pending",
        "createdAt": "2026-09-09T12:07:06.483Z",
        "updatedAt": "2026-09-09T12:07:06.483Z"
    }
}

Modified at 2026-09-26 21:17:03

Global mailbox-domain search

List Connected Accounts