Tier

A tier is a level or slab within a loyalty program that customers can move up, renew, or be downgraded from based on their engagement with the brand.

Tier Upgraded (tierUpgraded)

Notifies when a user's tier is upgraded.

{
    "apiRequestId": "1344ffd5-7b6f-4af0-a23d-ce354da13c76",
    "createdAt": 1720440349027.0,
    "data": {
        "customerIdentifiers": {
            "customerId": 379499720.0
        },
        "entityInformation": {
            "entityId": 1676.0,
            "entityType": "entityType"
        },
        "loyaltyProgramDetails": {
            "id": 1676.0,
            "isDefault": null,
            "name": "name",
            "pointsToCurrencyRatio": 1677.0,
            "tiers": null
        },
        "loyaltyProgramId": 1676.0,
        "notes": "notes",
        "previousTierNumber": 1676.0,
        "tierExpiryDate": "tierExpiryDate",
        "triggeringActivity": {
            "additionalAttributes": null,
            "enteredBy": null,
            "entityInformation": null,
            "identifiers": null,
            "name": "name"
        },
        "upgradeType": "upgradeType",
        "upgradedTierNumber": 1676.0
    },
    "eventId": "ccf65d56-1e34-4282-b9ad-8fe3fe558b74",
    "eventName": "tierUpgraded",
    "loyaltyEventId": null,
    "orgId": 50952.0,
    "refId": "50952_7250807"
}

Tier Renewed Event (tierRenewed)

Notifies when a user's tier has been renewed.

{
    "apiRequestId": "1344ffd5-7b6f-4af0-a23d-ce354da13c76",
    "createdAt": 1720435141002.0,
    "data": {
        "currentTierNumber": 1676.0,
        "customerIdentifiers": {
            "customerId": 379499720.0
        },
        "entityInformation": {
            "entityId": 1676.0,
            "entityType": "entityType"
        },
        "loyaltyProgramDetails": {
            "id": 1676.0,
            "isDefault": null,
            "name": "name",
            "pointsToCurrencyRatio": 1677.0,
            "tiers": null
        },
        "loyaltyProgramId": 1676.0,
        "notes": "notes",
        "renewType": "renewType",
        "tierExpiryDate": "tierExpiryDate",
        "triggeringActivity": {
            "additionalAttributes": null,
            "enteredBy": null,
            "entityInformation": null,
            "identifiers": null,
            "name": "name"
        }
    },
    "eventId": "ccf65d56-1e34-4282-b9ad-8fe3fe558b74",
    "eventName": "tierRenewed",
    "loyaltyEventId": null,
    "orgId": 50952.0,
    "refId": "50952_7250807" }

Tier Downgraded Event (tierDowngraded)

Notifies when a user's tier is downgraded. Includes the downgraded tier information.

{
    "apiRequestId": "1344ffd5-7b6f-4af0-a23d-ce354da13c76",
    "createdAt": 1720435042600.0,
    "data": {
        "customerIdentifiers": {
            "customerId": 379499720.0
        },
        "downgradedTierNumber": 1676.0,
        "entityInformation": {
            "entityId": 1676.0,
            "entityType": "entityType"
        },
        "loyaltyProgramDetails": {
            "id": 1676.0,
            "isDefault": null,
            "name": "name",
            "pointsToCurrencyRatio": 1677.0,
            "tiers": null
        },
        "loyaltyProgramId": 1676.0,
        "previousTierNumber": 1676.0,
        "tierExpiryDate": "tierExpiryDate",
        "triggeringActivity": {
            "additionalAttributes": null,
            "enteredBy": null,
            "entityInformation": null,
            "identifiers": null,
            "name": "name"
        }
    },
    "eventId": "ccf65d56-1e34-4282-b9ad-8fe3fe558b74",
    "eventName": "tierDowngraded",
    "loyaltyEventId": null,
    "orgId": 50952.0,
    "refId": "50952_7250807"
}

Tier Downgrade Reminder Event (tierDowngradeReminder)

Notifies when a user is approaching a tier downgrade.

{
    "apiRequestId": "1344ffd5-7b6f-4af0-a23d-ce354da13c76",
    "createdAt": 1720440490349.0,
    "data": {
        "currentTierNumber": 1676.0,
        "customerIdentifiers": {
            "customerId": 379499720.0
        },
        "entityInformation": {
            "entityId": 1676.0,
            "entityType": "entityType"
        },
        "loyaltyProgramDetails": {
            "id": 1676.0,
            "isDefault": null,
            "name": "name",
            "pointsToCurrencyRatio": 1677.0,
            "tiers": null
        },
        "loyaltyProgramId": 1676.0,
        "scheduledDowngradeDate": "scheduledDowngradeDate",
        "triggeringActivity": {
            "additionalAttributes": null,
            "enteredBy": null,
            "entityInformation": null,
            "identifiers": null,
            "name": "name"
        }
    },
    "eventId": "ccf65d56-1e34-4282-b9ad-8fe3fe558b74",
    "eventName": "tierDowngradeReminder",
    "loyaltyEventId": null,
    "orgId": 50952.0,
    "refId": "50952_7250807"
}