---
schema_version: "1"
id: 731397b0f0ed3f90f9ab61fb144da81809ab373202daede275dbc1ca4aae233e
title: Promotion Configuration 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_configuration_api.md
canonical_url: https://help.salesforce.com/s/articleView?id=mktg.global_promotions_management_run_pricing_promotion_configuration_api.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 479f43429d5d7ab7a68d64188507a5ae6316a78fe7e263e35bbbbc8f4e645e13
description: Use the Promotion Configuration API to access and export active promotion configurations.
products:
  - Marketing
release: "264"
---
# Promotion Configuration API

Use the Promotion Configuration API to access and export active promotion configurations.

### 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>

Developers and system integrators use the API's response to export a promotion's configuration to external systems that aren't connected to Salesforce, such as an offline POS. By doing this, your company can manage promotions in Salesforce and apply promotions for customer orders on disconnected systems that interact with customers and manage their orders.

The API response includes a promotion's definition, eligibility criteria, rules, limits, and related rule library version. Behind the scenes, Global Promotions Management uses Business Rules Engine to store the configuration of promotions.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-mktg-real_time_offer_management-264-0-0-production-enus/9bd7649d-776f-43e6-b210-f781a48bbc79/images/icon_note.png)

Note The Promotion Configuration API response doesn't include the coupons associated with a promotion. To find the coupons associated with a promotion, run the sObject API for the Coupon object. You can filter the API's response by running the API with the ID of the promotion you want to find coupons for.

To learn more about the API and Business Rules Engine, see:

- [Promotion Configuration API](https://developer.salesforce.com/docs/atlas.en-us.loyalty.meta/loyalty/connect_resources_promotion_configuration.htm)
- [Business Rules Engine](https://help.salesforce.com/s/articleView?id=ind.business_rules_engine.htm&language=en_US)