---
title: "Email a creator"
method: POST
path: "/campaigns/{campaignId}/creators/{creatorId}/emails"
tags: ["emails"]
---

# Email a creator

`POST /campaigns/{campaignId}/creators/{creatorId}/emails`

## Request

- Base URL: `https://www.creatorriver.com/api/v1`
- URL: `https://www.creatorriver.com/api/v1/campaigns/{campaignId}/creators/{creatorId}/emails`
- Auth: HTTP bearer

Sends a plain-text email to the creator’s revealed address (call reveal_contact first). Replies arrive in the conversation (see get_conversation). The first 100 emails each day are free; after that each costs 0.1 credits, up to the daily limit (see get_account). Sending the same subject and body to the same creator in the same campaign again returns the first send instead of emailing twice; pass a new idempotencyKey to send it again on purpose.

## Path parameters

- `campaignId` string, required: Campaign id, from list_campaigns or create_campaign
- `creatorId` string, required: Creator id, from search_creators results

## Request body

- object
  - `subject` string, required: Email subject
  - `body` string, required: Email body, plain text
  - `idempotencyKey` string: Retries with the same key never send twice

## Response `200`

Success

- object
  - `data` unknown, required

## Other responses

- `4XX`: Failure; `error.code` says what to do
- `5XX`: Failure; `error.code` says what to do

---

[API](https://skmtc.dev/creatorriver/apis/creator-river-api.md) · [All operations](https://skmtc.dev/creatorriver/apis/creator-river-api/llms.txt) · [OpenAPI document](https://skmtc.dev/creatorriver/apis/creator-river-api/revisions/d3707b18785c?raw)