curl --request POST \
--url https://api.voucherify.io/v2/loyalties/tier-structures/{id}/tiers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-App-Id: <api-key>' \
--header 'X-App-Token: <api-key>' \
--data '
{
"name": "<string>",
"qualification_rules": {
"min_value": 1,
"max_value": 1,
"segment": {
"id": "<string>"
}
},
"downgrade": {},
"metadata": {}
}
'{
"id": "<string>",
"tier_structure_id": "<string>",
"name": "<string>",
"downgrade": {},
"metadata": {},
"created_at": "2023-11-07T05:31:56Z",
"qualification_rules": {
"min_value": 1,
"max_value": 1,
"segment": {
"id": "<string>"
}
},
"updated_at": "2023-11-07T05:31:56Z"
}Create Tier
⚠️ BETA endpoint
This is a work-in-progress documentation of a BETA endpoint. The parameters, fields, request and response bodies, and other data may subject to change. If you want to share feedback or improvements, contact Voucherify support or your Technical Account Manager.
Creates a new tier within the specified tier structure.
Maximum of 10 tiers per tier structure.
When qualification_rules.type is POINTS, min_value is required and point ranges
must not overlap with existing tiers.
When qualification_rules.type is SEGMENT, segment.id is required and must
reference a valid segment.
downgrade.type defaults to INHERIT if omitted.
curl --request POST \
--url https://api.voucherify.io/v2/loyalties/tier-structures/{id}/tiers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-App-Id: <api-key>' \
--header 'X-App-Token: <api-key>' \
--data '
{
"name": "<string>",
"qualification_rules": {
"min_value": 1,
"max_value": 1,
"segment": {
"id": "<string>"
}
},
"downgrade": {},
"metadata": {}
}
'{
"id": "<string>",
"tier_structure_id": "<string>",
"name": "<string>",
"downgrade": {},
"metadata": {},
"created_at": "2023-11-07T05:31:56Z",
"qualification_rules": {
"min_value": 1,
"max_value": 1,
"segment": {
"id": "<string>"
}
},
"updated_at": "2023-11-07T05:31:56Z"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Unique tier structure identifier.
Body
Display name.
1 - 200When type is POINTS, min_value is required. max_value is optional but if
provided must be >= min_value. Cannot have max_value without min_value.
When type is SEGMENT, segment is required and min_value/max_value are not allowed.
Show child attributes
Show child attributes
Downgrade override. Default: INHERIT.
Show child attributes
Show child attributes
Custom key-value metadata.
Response
Created tier
A tier resource as returned by the API.
Unique tier identifier.
ID of the parent tier structure.
Display name.
200Show child attributes
Show child attributes
Custom key-value metadata.
ISO 8601 creation timestamp.
Object type discriminator.
tier Rules determining how members qualify for this tier.
Show child attributes
Show child attributes
ISO 8601 last-update timestamp.
Was this page helpful?