Grant a tier to a member
partner:loyalty:programs:writeManually places a member in this tier, bypassing the qualifier — for example for a comped VIP.
AuthorizationBearer <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.
programExternalId*stringExternal id of the loyalty program that owns the tier ladder.
tierExternalId*stringExternal tier id.
application/json- body
memberExternalId*stringThe member's opaque external id — never an internal integer id.
1 <= lengthnote?stringWhy this member qualified. Recorded as grant provenance (audit).
length <= 2000organizationId?stringExternal org id — global/superadmin callers only.
validThrough?stringCalendar end of the conferred term. Omitted = open-ended.
The created grant.
curl -X POST 'https://api-prd.cf.journey.com/v1/partner/loyalty/programs/string/tiers/string/grants' \ -H 'Content-Type: application/json' \ -d '{ "memberExternalId": "string"}'