# Offer Ingestion
source: https://developer.mastercard.com/eop-admin/documentation/use-cases/offers/index.md

## Create Offer {#create-offer}

The Create Offer API enables the ingestion of offers for Merchants. These offers are generated based on the configurations and data provided during the Merchant and media ingestion process. Refer to the [API Reference](https://developer.mastercard.com/eop-admin/documentation/api-reference/index.md) page for further information about each endpoint.

### Prerequisites {#prerequisites}

Refer to the following prerequisites for the customer to use this endpoint:

* The [source data](https://developer.mastercard.com/eop-admin/documentation/use-cases/sources/index.md) is used for offer creation.
* [Merchant](https://developer.mastercard.com/eop-admin/documentation/use-cases/merchants/index.md) data is used for offer ingestion. If the media is provided in the payload, it will be used for the offers. Otherwise, media will be sourced directly from the Merchant.
* The source should have a valid contract for the offer ingestion.

### Sequence diagram {#sequence-diagram}

Diagram offer_create

### Execution steps {#execution-steps}

1. The Merchant aggregator sends the create request to Offer Ingestion API with path parameter Merchant UUID (Universal Unique Identifier) in the url and other parameters in the request payload [API Reference](https://developer.mastercard.com/eop-admin/documentation/api-reference/index.md).
2. Mastercard Gateway validates the client request.
3. Mastercard Gateway routes the POST /offers request to Offer Ingestion API in the case of valid request.
4. The request is validated with the application permissions using the key from the header.
5. The POST /offers request creates the offer with the Merchant in the payload and returns a successfully created response (201).
6. The Offer Ingestion API returns a response with a status code of 4XX/5XX in case of an invalid request.

### API structure {#api-structure}


API Reference: `GET /offers`

## Next steps {#next-steps}

Verify that the offers are created successfully. If the offer is not valid, contact the Mastercard Operations Team directly.

Now that you understand the different use cases, proceed to the [API Reference](https://developer.mastercard.com/eop-admin/documentation/api-reference/index.md) section to interact with all of our endpoints on the API explorer.