Create a fallback offer

Last update: 2023-10-18
  • Created for:
  • Experienced

You can create a fallback offer by making a POST request to the Offer Library API.

Accept and Content-Type headers

The following table shows the valid values which comprise the Content-Type field in the request header:

Header name Value
Content-Type application/json

API format

POST /{ENDPOINT_PATH}/offers/{ID}?offer-type=fallback
Parameter Description Example
{ENDPOINT_PATH} The endpoint path for persistence APIs.


curl -X POST '' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
    "name": "Test Fallback Offer DPS",
    "description": "Fallback Offer description",
    "status": "approved",
    "selectionConstraint": {
        "startDate": "2022-06-10T00:30:00.000+00:00",
        "endDate": "2032-06-06T23:29:21.402+00:00",
        "profileConstraintType": "none"
    "representations": [
            "components": [
                    "deliveryURL": "",
                    "type": "imagelink",
                    "format": "image/png"
            "channel": "",
            "placement": "offerPlacement1234"
    "rank": {
        "priority": 1


A successful response returns information on the newly created fallback offer, including its unique fallback offer id. You can use the id in later steps to update or delete your fallback offer or to create a decision in a later tutorial.

    "etag": 2,
    "createdBy": "{CREATED_BY}",
    "lastModifiedBy": "{MODIFIED_BY}",
    "id": "{ID}",
    "sandboxId": "{SANDBOX_ID}",
    "createdDate": "2023-05-31T15:09:11.771Z",
    "lastModifiedDate": "2023-05-31T15:09:11.771Z",
    "createdByClientId": "{CREATED_CLIENT_ID}",
    "lastModifiedByClientId": "{MODIFIED_CLIENT_ID}"

On this page