Skip to main content
POST
/
v1
/
renders
/
{id}
/
email
Email a render to a recipient
curl --request POST \
  --url https://api.craftkit.dev/v1/renders/{id}/email \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "to": "client@example.com",
  "recipientName": "Jane Doe",
  "message": "Please find your invoice attached."
}
'
{
  "id": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d",
  "shareToken": "shr_abc123",
  "shareUrl": "https://api.craftkit.dev/share/shr_abc123",
  "emailMessageId": "re_xxx",
  "sentAt": "2026-06-21T10:05:00.000Z"
}

Authorizations

Authorization
string
header
required

Project API key (ck_live_… or ck_test_…) presented as a bearer token. For embed partner endpoints this is the partner secret key, which is the same credential type.

Path Parameters

id
string<uuid>
required

The render id.

Body

application/json
to
string<email>
required
recipientName
string
Maximum string length: 200
message
string
Maximum string length: 2000
expiresAt
string<date-time>

Response

Email sent.

id
string<uuid>
required
shareToken
string
required
shareUrl
string<uri>
required
emailMessageId
string
required
sentAt
string<date-time>
required