Journey Docs
Partner API ExplorerLoyaltyBenefits

Set benefit eligibility

Required scopepartner:loyalty:benefits:write
PUT
/v1/partner/loyalty/programs/{programExternalId}/benefits/{externalId}/eligibility

Full replacement of the rule deciding who receives the benefit. Rules may only reference attributes listed by GET /v1/partner/loyalty/rule-attributes.

Authorization

headerAuthorizationBearer <token>

WorkOS access token (JWT) for a user who is a member of the partner organization. The organization the request is scoped to is taken from the token, not from a header or query parameter.

Only a JWT is accepted in this header. A Journey jny_ API key sent as a bearer token is rejected with 401 Invalid or expired token; send it in X-API-Key instead.

WorkOS organization API keys are not accepted yet.

Path Parameters

externalId*string

External benefit id.

programExternalId*string

External id of the loyalty program that owns the benefit.

Query Parameters

organizationId?string

External organization id (HXP UUID or WorkOS organization id). Only Journey superadmin callers may set it; for a partner credential the organization is taken from the credential and this parameter is ignored.

Request Body

application/json
  1. body
conditions*array<>
Items1 <= items
match*string
Value in"all""any"
window*

Response Body

The stored eligibility rule.

curl -X PUT 'https://api-prd.cf.journey.com/v1/partner/loyalty/programs/string/benefits/string/eligibility' \  -H 'Content-Type: application/json' \  -d '{  "conditions": [    {      "attribute": "string",      "operator": "eq",      "value": 0    }  ],  "match": "all",  "window": {    "type": "rolling"  }}'
Empty