---
title: "Send a triggered email (legacy flat URL shape)"
method: POST
path: "/v1/send-triggered"
tags: ["Send Email"]
---

# Send a triggered email (legacy flat URL shape)

`POST /v1/send-triggered`

## Request

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

Legacy flat URL shape, kept for backward compatibility - identical behavior to POST /v1/projectId/{projectId}/send-triggered above (which is the same handler; there is no projectId in this URL because the project is resolved entirely from triggeredId).

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).

## 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)