---
title: "Send an email from the account"
method: POST
path: "/accounts/send-commercial-email"
tags: ["Email Sending"]
---

# Send an email from the account

`POST /accounts/send-commercial-email`

## Request

- Base URL: `https://api.quiva.ai`
- URL: `https://api.quiva.ai/accounts/send-commercial-email`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/docs/accounts/send-commercial-email/post.ts> (a function with typed inputs; its response is checked against the schema)

The sanctioned send for account email. Stamps scope and class so suppression and consent apply. `queued` means accepted by the outbox, not delivered. Give either `template_key` with `data`, or `subject` with `html`/`text`, never both.

## Request body

- object
  - `to` string, required: Recipient
  - `subject` string: Subject
  - `html` string: HTML body
  - `text` string: Text body
  - `from_address` string: From address
  - `reply_to` string: Reply-to
  - `template_key` string: Published email template to render
  - `data` object: Template tag values
  - `contact_folder` string: Contact folder the mail belongs to
  - `task_id` string: Task the mail belongs to
  - `class` string: commercial (default) or transactional
  - `cc` string[]
  - `bcc` string[]
  - `idempotency_key` string: Collapses repeats inside the outbox duplicate window
  - `ref` object: Sender keys echoed on the activity row and delivery events
  - `attachments` object[]
  - `attachment_refs` object[]

## Response `200`

Success

- object
  - `data` object
    - `queued` boolean

## Other responses

- `400`: Bad request
- `401`: Unauthorized

## Changes

- **2026-11-12** `700eb1ace61a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/changes/accounts/send-commercial-email/post.md)

---

[API](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway.md) - [All operations](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/revisions/700eb1ace61a?raw)