Resolve Qualifiers

POST/organizations/{organizationId}/qualifiers/resolve

Use it in a workflow

Add a step and choose the Salesforce Commerce Cloud connector.
Pick the Resolve Qualifiers action (under Shopper Experience).
Fill in the fields below, then reference the result from later steps as {{resolveQualifiers.response.data}}.

Request

Path parameters

organizationIdstringrequired

An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).

Query parameters

siteIdstringrequired

The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.

localeoneOf

A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.

Request body

Enter the body as JSON in the step's Body field.

customerGroupsarray<string>

List of customer group identifiers to resolve qualification for.

campaignQualifiersarray<object>

List of campaign qualifiers to resolve. Each qualifier must include a campaignId and may optionally include a promotionId.

campaignIdstringrequired

The campaign identifier.

promotionIdstring

Optional promotion identifier. When provided, qualification requires both the campaign and the specific promotion-campaign assignment to apply.

dataBindingsarray<object>

List of data binding requirements to resolve, each specifying a provider type and record identifier.

typestringrequired

The data provider type identifier.

idstringrequired

The record identifier to resolve from the data provider.

json

{
  "customerGroups": [
    "VIP"
  ],
  "campaignQualifiers": [
    {
      "campaignId": "my-campaign",
      "promotionId": "my-promotion"
    }
  ],
  "dataBindings": [
    {
      "type": "content_asset",
      "id": "homepage-banner"
    }
  ]
}

Response

Returns 200 with an object. Read it in later steps with {{resolveQualifiers.response.data.<field>}}.

customerGroupsobject

Map of customer group identifiers to their qualification status. True if the user is qualified, false otherwise.

campaignQualifiersobject

Map of campaign ID to promotion qualification results. Each value is a map of promotion ID to qualification result. Only contains entries for request qualifiers that included a promotionId.

campaignsobject

Map of campaign ID to qualification result for request qualifiers that did not include a promotionId. A value of true means the campaign is active and its scenario rule applies to the shopper context.

dataBindingsobject

Resolved data binding objects grouped by provider type, then by record identifier. Used by the expression resolver to evaluate attribute expressions.

json

{
  "customerGroups": {
    "VIP": true
  },
  "campaignQualifiers": {
    "my-campaign": {
      "my-promotion": false
    }
  },
  "campaigns": {
    "winter-promo": false
  },
  "dataBindings": {
    "content_asset": {
      "homepage-banner": {
        "title": "Winter Sale",
        "body": "<div>Shop our winter collection</div>",
        "showCountdown": true,
        "endDate": "2026-03-31T23:59:59Z"
      }
    }
  }
}

Need more? See the Salesforce Commerce Cloud guide for connection setup and behaviour shared by every action.

Was this page helpful?