> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api.md).

# Campaign management API

- [Product campaign](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/productcampaign-1.md)
- [Create a product campaign](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/productcampaign-1/createproductcampaign.md): This endpoint creates a new product campaign with the marketing settings and product selections. Set up campaign details like budget, duration, and which products to promote. The campaign will be read
- [Retrieve list of all product campaigns](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/productcampaign-1/listproductcampaigns.md): This endpoint shows all product campaigns with options to filter and sort them. Search by campaign name, team, approval status, and more. Results are shown in pages to make them easier to view and man
- [Update product campaign](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/productcampaign-1/updateproductcampaign.md): This endpoint updates an existing product campaign settings. Modify campaign details like name, catalog assignments, and other campaign options.
- [Approve or reject product campaign](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/productcampaign-1/approveproductcampaign-1.md): This endpoint allows approval or rejection of a product campaign. Change the approval status and provide rejection reasons if needed.
- [Get product campaign for specified ID](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/productcampaign-1/getproductcampaign-1.md): This endpoint retrieves the complete details of a specific product campaign using its unique ID. View all campaign settings, performance data, and current status. Note: requestTeamId is required for s
- [Check fixed tenancy campaign availability](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/productcampaign-1/checkfixedtenancyavailable-1.md): This endpoint checks if a fixed tenancy campaign can be booked for specified dates and placement. It shows any conflicts with existing campaigns and confirms availability.
- [Banner X campaign](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/bannerxcampaign-1.md)
- [Create a banner X campaign](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md): Creates a new banner X campaign using the details provided in the request body. This endpoint allows you to define campaign parameters, targeting, strategy, and other configurations to launch a new ca
- [Get banner X campaign details](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/bannerxcampaign-1/getbannerxcampaign-1.md): Retrieves banner X campaign details for the specified campaign ID.
- [Update Banner X campaign](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/bannerxcampaign-1/updatebannerxcampaign.md): This endpoint allows you to update an existing Banner X campaign by providing the campaign ID and the updated campaign data in the request body. You can modify campaign properties such as name, target
- [Update banner X campaign approval state](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/bannerxcampaign-1/approvebannerxcampaign-1.md): Updates the approval state of a specified banner X campaign. You can approve or reject the campaign by setting the appropriate state and providing a rejection reason if necessary.
- [Retrieve list of all banner X campaigns](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/bannerxcampaign-1/listbannerxcampaigns.md): Retrieves a list of banner X campaigns based on specified filters and parameters, including campaign name, placement ID, team ID, approval state, and more. Supports pagination and sorting to manage la
- [Banner campaign](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/bannercampaign.md)
- [Create a banner campaign](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/bannercampaign/createbannercampaign-1.md): Creates a new banner campaign using the details provided in the request body. This endpoint allows you to define campaign parameters, targeting, strategy, and other configurations to launch a new camp
- [Get banner campaign details](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/bannercampaign/getbannercampaign-1.md): Retrieves banner campaign details for the specified campaign ID.
- [Update banner campaign](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/bannercampaign/updatebannercampaign.md): This endpoint updates an existing banner campaign by its unique identifier. It allows partial updates to campaign properties including name, scheduling, targeting, budget settings, and banner configur
- [Update banner campaign approval state](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/bannercampaign/approvebannercampaign.md): Updates the approval state of a specified banner campaign. You can approve or reject the campaign by setting the appropriate state and providing a rejection reason if necessary.
- [Campaign files](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/creativeassets.md)
- [Upload a campaign file](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/creativeassets/uploadfile.md)
- [Upload a campaign file - v4](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/creativeassets/uploadfile-2.md): This endpoint allows uploading different types of campaign files including banners, banner X, and brand pages. It includes support for hero image display modes and background positioning controls. Acc
- [Retrieve campaign file URL](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/creativeassets/getcampaignfileurl.md): This endpoint retrieves the URL for uploaded campaign assets for banners, banner X, and brand page campaigns. The URL is generated based on the specified file ID and file type.
- [Content standard](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/bannerxcontentstandard.md)
- [Get Banner X content standard details](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md): Retrieves Banner X content standard details for the specified content standard ID.
- [Retrieve list of content standards for Banner X campaigns](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/bannerxcontentstandard/listbannerxcontentstandard.md): Retrieves the list of content standards for Banner X campaigns based on the specified parameters, such as namespace, name, and content standard ID.
- [Get banner content standard details](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/bannerxcontentstandard/getbannercontentstandard.md): Retrieves Banner content standard details for the specified content standard ID.
- [Retrieve list of content standards for banner campaigns](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/bannerxcontentstandard/listbannercontentstandard.md): Retrieves the list of content standards for banner campaigns based on the specified parameters, such as namespace, name, and content standard ID.
- [Campaign](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/campaign.md)
- [Retrieve list of all campaigns](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/campaign/listcampaigns-1.md): This endpoint retrieves a list of campaigns based on specified filters and parameters such as campaign name, campaign type, placement ID, team ID, approval state, and more. A date range (from and to)
- [Retrieve campaign history](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/campaign/getcampaignhistory.md): Retrieve a campaign's history using its campaign ID. You can access the entire campaign history or specify a date range by using the fromDate and toDate parameters.
- [Retrieve minimum bid details for keywords](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/campaign/retrievekeywordsminbid.md): Retrieve individual minimum bid details and the overall campaign minimum bid for an array of specified keywords in Search and Category & Search placement type campaigns.
- [Retrieve minimum bid details for category](https://help.citrusad.com/retail-media-interface/partner/campaign-management-api/campaign/retrievecategoryminbid.md): Retrieve individual minimum bid details and the overall campaign minimum bid for category placement type campaigns.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.citrusad.com/retail-media-interface/partner/campaign-management-api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.