---
title: "Send Creator Invites Endpoint"
method: POST
path: "/api/v1/remy/creator-invites/send"
tags: ["remy"]
---

# Send Creator Invites Endpoint

`POST /api/v1/remy/creator-invites/send`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/remy/creator-invites/send`
- Auth: HTTP bearer

Email a batch of roster creators an invite, each to the tier set against their own row.

Roster work, not campaign outreach — no campaign is taken or filed against. Creators with no
email, already on the tier offered, or invited within the repeat window come back under
`skipped`; none of them fails the batch. Poll GET /email-fallback/status/{job_id} to follow it.

## Request body

- SendCreatorInvitesRequestDTO: Roster invites, not campaign outreach — there is no campaign to name. Email, visibility and the invite link are all resolved server-side; only the creator and the tier come from the FE. A creator who was invited within the repeat window and has not replied is skipped, as is one already holding the tier being offered — both are reported, neither fails the batch.
  - `items` CreatorInviteTargetDTO[], required
    - `creator_id` string, required
    - `plan` 'registered' | 'recognized' | 'elite', required
  - `template_id` string, nullable
  - `utm_campaign` string, nullable
  - `sender` string, email, nullable
  - `attachments` EmailAttachmentDTO[], nullable
    - `filename` string, required
    - `content_base64` string, required
    - `content_type` string, nullable
  - `subject` string, nullable

## Response `200`

Successful Response

- StartCreatorInviteSendResponseDTO
  - `job_id` string, required
  - `total` integer, required
  - `queued` integer, required
  - `skipped` CreatorInviteSkipDTO[]
    - `creator_id` string, required
    - `reason` string, required

## Other responses

- `422`: Validation Error

## Changes

> 36 revisions in range; 1 not diffed.

- **2026-10-14** `707bf96f76de`: 1 info
  - added the new optional request property `subject`
- **2026-09-30** `05ad3a41b4cf`: 1 info
  - added the new optional request property `attachments`
- **2026-09-16** `dda5cf04b73d`: 1 info
  - added the new optional request property `sender`
- **2026-09-11** `163530d84bc1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brandbooster/apis/brandbooster-api/changes/api/v1/remy/creator-invites/send/post.md)

---

[API](https://skmtc.dev/brandbooster/apis/brandbooster-api.md) - [All operations](https://skmtc.dev/brandbooster/apis/brandbooster-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/brandbooster-api/revisions/f84fc05f417b?raw)