---
title: "Send Email Message"
method: POST
path: "/v2/emails"
tags: ["Emails"]
---

# Send Email Message

`POST /v2/emails`

This endpoint allows you to send a single email. Query parameters are supported.

## Query parameters

- `unsubscribeMsg` string

## Request body

- EmailRequest — Email request
  - `message` string — Text to send
  - `clientId` string — Client id associated with registry
  - `externalId` string — Allows you to use a custom ID for tracing your Notifications.
  - `to` string, required — Recipient that receives the message
  - `from` string, required — Email address that delivers the message
  - `subject` string, required — Email subject

## Response `200`

Accepted the request to send the email

- EmailResponse
  - `meta` MetadataDTO
    - `timestamp` integer, required — Transaction's date in timestamp
    - `transactionId` string, required — Id for the current transaction (Endpoint's call)
    - `explain` string — Explain string in case of failure
  - `data` EmailDTO — Data contained in the Email.
    - `id` string, required — Unique identifier of the Email.
    - `date` string, date-time, required — Date when the Email has been sent.
    - `to` string, required — <p>Recipient’s email address.</p>
    - `from` string, required — <p>Sender's verified email address.</p>
    - `userName` string, required — <p>Owner or creator of the Email.</p>
    - `operator` string, required — <p>User who is a member of the owner or creator’s Workspace.</p>
    - `text` string, required — <p>Email content (can be plain text or HTML).</p>
    - `status` string, required — <p>It represents the current state of the email within the system.</p> <p>When an email is sent, the system assigns one of several possible statuses to track its delivery progress.</p> <p>To view the full list and meaning of each status, please refer to the <a href='https://docs.messangi.com/docs/email-status'>Email Status</a> section.</p>
    - `subject` string, required — <p>Subject line of the email.</p>
    - `externalId` string, required — <p>Alphanumeric identifier used for reporting purposes.</p>
    - `clientId` string — <p>Unique user identifier that can be used for reporting purposes. This is an identifier you can use to uniquely identify the destination address in your systems. This is similar to the externalId and will be sent back to you if you are requesting callbacks that contain status changes of the messages you send.</p>
    - `callbacks` string[] — <p>Indicate one or more (separated by comma) webhook URLs to notify about the status of the message delivery.That is, If you want to receive the status of the message you've sent to your contacts, you need to specify your endpoint.</p> <p>Your endpoint must have a <b>HTTP POST</b> access method and receive a JSON body.</p> <p>The URL is the external callback where the events of the Email will be registered and published. Once an email is processed, its status will be posted to your callback URL.</p><p>To view the full list and meaning of each status, please refer to the <a href='https://docs.messangi.com/docs/email-status'>Email Status</a> section.</p>
    - `alias` string — <p>Custom label or reference name to the email recipient.</p>
    - `statusDate` string, date-time, required — Date when the last update or status change.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Credentials not found
- `410` — Token expired
- `500` — Internal server error

---

[API](https://skmtc.net/messangi/apis/raven.md) · [All operations](https://skmtc.net/messangi/apis/raven/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/messangi/raven/versions/c87f398fa338/schema)