---
title: "Queue an outreach email to a prospect. It sends from the workspace's own connected mailbox, paced automatically with a daily cap. Uses the stored draft unless subject/body are given (a reply to a prospect who answered must pass both); a \"[Your name]\" sign-off in the draft is replaced with the owner's profile name at send time. Dry-run unless confirm is true — a confirmed queue leads to a REAL email being sent. When the person asked for this, call it with confirm=true."
method: POST
path: "/api/v1/outreach/queue"
---

# Queue an outreach email to a prospect. It sends from the workspace's own connected mailbox, paced automatically with a daily cap. Uses the stored draft unless subject/body are given (a reply to a prospect who answered must pass both); a "\[Your name\]" sign-off in the draft is replaced with the owner's profile name at send time. Dry-run unless confirm is true — a confirmed queue leads to a REAL email being sent. When the person asked for this, call it with confirm=true.

`POST /api/v1/outreach/queue`

## Request

- Base URL: `https://api.rctrl.com`
- URL: `https://api.rctrl.com/api/v1/outreach/queue`
- Auth: HTTP bearer

Requires the `write:content` scope.

## Request body

- object
  - `backlinkId` string, required: Prospect id from list_outreach_prospects
  - `subject` string: Override the drafted subject
  - `body` string: Override the drafted body
  - `confirm` boolean: Set true to actually queue the send

## Response `200`

Success; the payload is wrapped in a data envelope

- object
  - `data` unknown

## Other responses

- `400`: Bad input
- `401`: Missing or invalid API key
- `403`: API key lacks the required scope
- `404`: Not found in this workspace
- `429`: Rate limited; the body includes a retryAfterMs hint

---

[API](https://skmtc.dev/rctrl/apis/rankcontrol-api.md) · [All operations](https://skmtc.dev/rctrl/apis/rankcontrol-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rctrl/apis/rankcontrol-api/revisions/98ecd236394a?raw)