> For the complete documentation index, see [llms.txt](https://docs.antsomi.com/api-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.antsomi.com/api-guide/endpoint/promotion-api.md).

# Promotion API

### Introduction

The Promotion API endpoints provide access to CDP promotion data within our system. These endpoints enable you to import your promotion code from a third-party promotion engine into CDP and more, allowing your application to interact with our event data.

### Authentication

To access these endpoints, you will need to authenticate your requests using OAuth 2.0 and ensure that the access token is authenticated with the scope `promotion`. Please refer to our [Authentication Guide](#base-url) for details on how to obtain an access token.

{% openapi src="/files/slFgsxWi30I6PBr8NaTX" path="/api/promotion/pool" method="post" %}
[promotion.yaml](https://4137638855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLclllpxtah4ilNijP5l5%2Fuploads%2FZrALwjGJRUFCcdeKebLr%2Fpromotion.yaml?alt=media\&token=d3712320-b059-4f92-b89c-eb076a7214ac)
{% endopenapi %}

{% openapi src="/files/slFgsxWi30I6PBr8NaTX" path="/api/promotion/import" method="post" %}
[promotion.yaml](https://4137638855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLclllpxtah4ilNijP5l5%2Fuploads%2FZrALwjGJRUFCcdeKebLr%2Fpromotion.yaml?alt=media\&token=d3712320-b059-4f92-b89c-eb076a7214ac)
{% endopenapi %}

{% openapi src="/files/slFgsxWi30I6PBr8NaTX" path="/api/item/search" method="post" %}
[promotion.yaml](https://4137638855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLclllpxtah4ilNijP5l5%2Fuploads%2FZrALwjGJRUFCcdeKebLr%2Fpromotion.yaml?alt=media\&token=d3712320-b059-4f92-b89c-eb076a7214ac)
{% endopenapi %}