---
title: "Create a promotion enrollment"
method: POST
path: "/v2/promotions"
tags: ["Promotions", "Experimental"]
---

# Create a promotion enrollment

`POST /v2/promotions`

Enrolls an account into an existing promotion.

Endpoint available to Partners only.
The request must be authenticated by an [access token](https://docs.zapier.com/powered-by-zapier/api-reference/authentication#retrieving-a-user-access-token)
that the user has granted to the Partner for the account.

The `enrollment_id`, returned after successfully enrolling a user,
**must** be stored by the partner in order to [retrieve](https://docs.zapier.com/powered-by-zapier/api-reference/promotions/get-enrollment)
or [delete](https://docs.zapier.com/powered-by-zapier/api-reference/promotions/delete-enrollment) the enrollment.

#### OAuth

This endpoint requires the `promotions:write` OAuth scope.

## Request body

- PromotionEnrollment
  - `promotion_id` string, required — The unique identifier for the promotions

## Response `201`

Successful Enrollment

- PromotionEnrollmentResponse — Successful Enrollment
  - `enrollment_id` string, required — The unique identifier for the enrollment. This must be stored by partners.

## Other responses

- `401` — Access denied: User does not have permission for enrollment_id: enroll_67890
- `403` — Forbidden - User lacks permission to access this location
- `404` — 404 Not Found
- `409` — Conflict - User is already enrolled in this promotion
- `429`
- `503`

---

[API](https://skmtc.dev/zapier/apis/trigger-inbox-api.md) · [All operations](https://skmtc.dev/zapier/apis/trigger-inbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zapier/trigger-inbox-api/revisions/3fc4c2846ba1/schema)