Create a decision rule

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

Decision rules are constraints added to a personalized offer and applied to a profile to determine eligibility.

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}/offer-rules
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": "Sales rule",
    "description": "Decisioning rule for sales",
    "condition": {
        "type": "PQL",
        "format": "pql/text",
        "value": "\"Joe\", false)"
    "definedOn": {
        "profile": {
            "schema": {
                "ref": "",
                "version": "1"
            "referencePaths": [


A successful response returns information on the newly created decision rule id. You can use the id in later steps to update or delete your decision rule or use it in a later tutorial to create decisions, decision rules, and fallback offers.

   "etag": 1,
    "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