The Create Promotion Enrollment endpoint allows you to enroll a user into an existing promotion by making a request to the /v2/promotions endpoint. This operation associates a user, identified by their user access token, with a specific promotion.
To enroll a user in a promotion, send a POST request to the /v2/promotions endpoint with the required parameters in the request body.
Here’s an example request:
Upon successful enrollment, the endpoint returns a JSON response containing the enrollment details.
The enrollment_id returned in the response can be used to track or manage the user’s enrollment in subsequent API calls.
Usage notes
- Ensure the promotion_id corresponds to an existing promotion in the system.
- The user_access_token must be valid and unexpired to authenticate the user correctly.
- This API is rate limited.
Enrollment expiration
Zapier can configure a promotion with an enrollment expiration period, agreed with you when the promotion is set up. When a promotion has one, each enrollment expires automatically at the end of that period, counted from the enrollment date. After the expiration date the enrollment status becomes expired and tasks stop being sponsored for that user. Zapier emails the user before the enrollment expires.
Promotions without an expiration period keep an enrollment active until you delete it.
Check the expiration date
Call the Get promotion enrollment endpoint. The response includes expiration_date and the current status:
expiration_date is null when the promotion has no expiration period.
Re-enroll an expired user
To sponsor the user again, send the same POST request to the Create promotion enrollment endpoint. An expired enrollment does not count as active, so the request returns 201 and the expiration period starts again from the new enrollment date. The enrollment_id stays the same for a given user and promotion.
A POST for a user whose enrollment is still active returns 409 with the already_enrolled error code.
Delete an expired enrollment
A DELETE request to the Delete promotion enrollment endpoint for an expired enrollment returns 204. The user does not receive an unenrollment email, because their sponsored access already ended when the enrollment expired. Last modified on October 28, 2026
