---
title: "Send a triggered email"
method: POST
path: "/v1/projectId/{projectId}/send-triggered"
tags: ["Send Email"]
---

# Send a triggered email

`POST /v1/projectId/{projectId}/send-triggered`

## Request

- Base URL: `https://api.bluefox.email`
- URL: `https://api.bluefox.email/v1/projectId/{projectId}/send-triggered`
- Auth: HTTP bearer

The project is resolved from triggeredId, not just the URL - the URL's projectId must match the triggered email's own project, or this 404s.

Sending fails with a 405 if the account is out of email credit ("Insufficient credits available") - there is no public endpoint to check remaining balance ahead of time, only in the app. It also fails with a 405 if a sandbox project's daily send cap is exceeded, or if bounce/complaint rates have triggered automatic restriction (see Project.status and GET .../sandbox/deliverability).

## Path parameters

- `projectId` string, required

## Request body

- object
  - `triggeredId` string, required: A triggered email _id, from GET /v1/projectId/{projectId}/triggered-emails - NOT a template ID.
  - `emails` string[]: Defaults to every active subscriber on the triggered email's subscriber list when omitted.
  - `data` unknown
  - `attachments` object[]
    - `filename` string
    - `content` string: Base64-encoded file content.

## Response `200`

OK, queued for sending

- object
  - `status` integer
  - `result` object
    - `success` boolean

## Other responses

- `400`: Invalid request body or query - every violation found (missing/invalid/unexpected fields) is reported in one response, semicolon-separated, not just the first one hit.
- `403`: Missing or invalid API key
- `404`: Triggered email not found
- `405`: The operation is blocked by a business rule (e.g. the resource is still in use)

---

[API](https://skmtc.dev/bluefox/apis/bluefox-email-public-api.md) · [All operations](https://skmtc.dev/bluefox/apis/bluefox-email-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bluefox/apis/bluefox-email-public-api/revisions/fa1a0a835c7f?raw)