---
schema_version: "1"
id: b8119101765f31775a46d877dd73b77a495684f812c054d4269f52507fe7c98d
title: TMF671 v4 Promotion Management API
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/industries-integrations/comms/guides/TMF671/TMF671.md
canonical_url: https://developer.salesforce.com/docs/industries/communications/guide/TMF671.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: de19954a7ab4bf44e5478ff136517020c7df48523c512f04dc35dac8b874ed78
products:
  - Communications Cloud TM Forum API
  - Industries Integrations
---
# TMF671 v4 Promotion Management API

The Promotion Management API (TMF671) offers a standardized way for service providers to configure and manage promotions.
Using the TMF671 API, service providers can determine, based on predefined criteria, whether promotions such as additional discounts, vouchers, bonuses, or gifts can be applied.

The Promotion Management API is certified by TM Forum.

![Certification](https://developer.salesforce.com/media/APIBadge.GOLDwNewLogo.png '{"class": "image-md"}')

**note:** - For TMF Open API release and specification version, see [Industry API Version](https://developer.salesforce.com/docs/industries/communications/industry_api_version.md).

## Access Methods

For the Spring'26 and Summer'26 releases, TMF671 v4 API can be accessed using either of the following methods.

- **Mule Gateway:** Access API through standard MuleSoft endpoints. For sample URLs, payloads, and parameter descriptions, see [Reference](https://developer.salesforce.com/docs/industries/communications/references/tmf671v4?meta=Summary) section for details on TMF671 v4 API MuleSoft endpoints.
- **Direct Access:** Bypass Mule Gateway using Connect/Apex REST endpoints.
  - See [TMF671 v4 Use Cases](https://developer.salesforce.com/docs/industries/communications/guide/TMF671use-cases.html) section for sample URLs and payloads.
  - See [TMF671 v4 Resource Mappings](https://developer.salesforce.com/docs/industries/communications/guide/tmf671_resource_mapping.html) section for parameter descriptions.

**important:** Starting from the Winter ’27 release, only the Direct Access option will be supported. The MuleSoft gateway option will be deprecated, and customers must update their integrations to use the Connect/Apex REST endpoints for continued access to the inbound APIs.

## Available In

This API is available in the Salesforce platform.

## Prerequisites

- Enable CommsCloud Advanced and RLM (Product discovery) licenses. Add Enterprise Edition, B2CLoyaltyManagementPlusAddon, and ContextService Admisn Psl (Permset License).
- Set up RLM. See [Product Discovery Setup](https://help.salesforce.com/s/articleView?language=en_US&id=sf.qocal_product_discovery_setup.htm&type=5).
- Set up [Global Promotions Management](https://help.salesforce.com/s/articleView?id=xcloud.global_promotions_management_setup.htm&type=5).
- Set up [Configuration Rules](https://help.salesforce.com/s/articleView?id=ind.product_configurator_set_up_configuration_rules.htm&type=5).

## Sample Apex URL (Direct Access Method)

TMF671 v4 API uses this URL format:

`{https://MyDomainLoginUrl}/services/data/{{version}}/connect/comms/promotionManagement/v4/promotion`.

## Use TMF671 v4 API

To access and use the TMF671 v4 API:

1. Authorize and use a connected app and an OAuth 2.0 authorization flow. See [Authorize Access](https://developer.salesforce.com/docs/industries/communications/authorization.md).
2. Trigger the API call. Refer the preceding section for sample URL.
3. Use the TMF671 v4 API resources and endpoints.
   - See [TMF671 v4 Use Cases](https://developer.salesforce.com/docs/industries/communications/guide/TMF671use-cases.html) section for sample URLs and payloads.
   - See [TMF671 v4 Resource Mappings](https://developer.salesforce.com/docs/industries/communications/guide/tmf671_resource_mapping.html) section for parameter descriptions.