---
title: "Send Custom Email"
method: POST
path: "/admin/custom-notifications/email"
tags: ["admin", "admin-api-key", "custom-notifications"]
---

# Send Custom Email

`POST /admin/custom-notifications/email`

## Request

- Base URL: `https://api.trytrata.com`
- URL: `https://api.trytrata.com/admin/custom-notifications/email`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Trata-Api-Key`

## Request body

- SendCustomEmailRequest
  - `user_ids` string[], required
  - `from_email` string, required
  - `subject` string, required
  - `cc_user_ids` string[]
  - `bcc_emails` string[]
  - `content_html` string, required

## Response `200`

Successful Response

- SendCustomNotificationResponse
  - `custom_notification_id` string, uuid, required
  - `results` RecipientResultResponse[], required
    - `user_id` string, required
    - `status` 'sent' | 'skipped_no_phone' | 'skipped_no_email' | 'skipped_lookup_failed' | 'skipped_opt_out' | 'failed', required
    - `error` string, nullable

## Other responses

- `404`: Not found
- `422`: Validation Error

## Changes

- **2026-10-28** `86e84046aceb`: 1 info
  - api tag `admin-api-key` added
- **2026-10-08** `18bb3630f150`: 2 info
  - added the new optional request property `bcc_emails`
  - added the new optional request property `cc_user_ids`
- **2026-10-06** `6a36db225fa7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trytrata/apis/fastapi/changes/admin/custom-notifications/email/post.md)

---

[API](https://skmtc.dev/trytrata/apis/fastapi.md) - [All operations](https://skmtc.dev/trytrata/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/trytrata/apis/fastapi/revisions/580522e6d1af?raw)