---
title: "Send an email"
method: POST
path: "/v3/email/message"
tags: ["v3", "Email"]
---

# Send an email

`POST /v3/email/message`

Send an email via SendGrid.

This endpoint allows sending emails via Definite's API using the platform SendGrid integration.
Useful for alert workflows where scheduled Python scripts need to send notification emails.

## Request body

- EmailMessageRequest
  - `toEmails` string[], required — List of recipient email addresses (validated)
  - `subject` string, required — Email subject line
  - `body` string, required — Email body content (HTML supported)

## Response `200`

Email sent successfully

- EmailMessageResponse
  - `ok` boolean, required — Whether the email was sent successfully

## Other responses

- `400` — Bad request - invalid parameters
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Validation Error
- `502` — Email delivery error

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/3943d8deb3be/schema)