---
title: "Create an affiliate invitation"
method: POST
path: "/v1/affiliates/invites"
tags: ["Affiliates"]
---

# Create an affiliate invitation

`POST /v1/affiliates/invites`

Invite someone to your affiliate program by email. They receive an invitation email and become an active affiliate once they accept. If `program_id` is omitted, the invitation is created for your store's affiliate program.

## Request body

- CreateAffiliateInviteRequestEntity
  - `email` string, required — The email address to send the affiliate invitation to.
  - `name` string, required — The display name of the affiliate being invited.
  - `program_id` string, nullable — The ID of the affiliate program to invite into. Optional: when omitted, the invitation falls back to the store's affiliate program. Provide this only if your store runs more than one program.

## Response `200`

Successfully created the affiliate invitation

- AffiliateInviteEntity
  - `id` string, required — Unique identifier for the object.
  - `mode` 'test' | 'prod' | 'sandbox', required — String representing the environment.
  - `object` string, required — String representing the object's type. Objects of the same type share the same value.
  - `email` string, required — The email address the affiliate was invited with.
  - `name` string, nullable — The display name the affiliate was invited with.
  - `status` string, required — The lifecycle status of the invitation: `pending` while the invitee has not yet accepted, `accepted` once they have joined the program.
  - `created_at` number, required — Creation date of the invitation as a timestamp.

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing API key
- `404` — Not Found - Resource does not exist
- `409` — Conflict - an invitation has already been sent to this email address

---

[API](https://skmtc.net/creem/apis/creem-api.md) · [All operations](https://skmtc.net/creem/apis/creem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/creem/creem-api/revisions/11305a63d3c9/schema)