---
schema_version: "1"
id: 0a8b00b422caa2cbc30f9f6b967ca8f2c2c8459e077b03255d2c144ab196e31e
title: Promotion Enrollment API
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/mktg/264-0-0/global_promotions_management_run_pricing_promotion_enrollment_api.md
canonical_url: https://help.salesforce.com/s/articleView?id=mktg.global_promotions_management_run_pricing_promotion_enrollment_api.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 87bd0840695c8bed18b26504bb04bb59ceb73969826019411885ace5651e8c6c
description: Use the Promotion Enrollment API to enroll a customer in a promotion and create an enrollment record. To provide a seamless experience, integrate this API with external systems such as shopping sites and mobile apps that manage customer profiles.
products:
  - Marketing
release: "264"
---
# Promotion Enrollment API

Use the Promotion Enrollment API to enroll a customer in a promotion and create an enrollment record. To provide a seamless experience, integrate this API with external systems such as shopping sites and mobile apps that manage customer profiles.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>,&nbsp;<strong>Unlimited</strong>, and&nbsp;<strong>Developer</strong>&nbsp;Editions with Real-Time Offer Management</td></tr></tbody></table>

At the promotion level, the enrollment start and end dates define the overall eligibility window for users. When you enroll a customer via Promotion Enrollment API using their identifying details, such as a contact or account, the API validates that the enrollment request occurs within the promotion's overall eligibility window. You can optionally provide the offer ID that initiated the enrollment, along with customer-specific start and end dates that define when the promotion applies to that specific customer. If you don't provide this start date and end date, the system uses the date and time of the API call as the start date and the promotion remains effective for the customer as long as the promotion is active, up until the promotion's end date.

The API response provides these enrollment details:

- Customer details, such as account or contact information.
- Promotion details, such as the promotion ID or promotion code.
- Promotion Party Usage ID, which is used to track the specific customer's enrollment.
- Enrollment expiration date and time, provided only if it was included in the input.
- Related offer details, provided only if it was included in the input.