Import customers into loyalty tiers

POST {{baseUrl}}/v1/loyalty_programs/:loyaltyProgramId/import_customers_tiers

Upload a CSV file containing existing customers to be assigned to existing tiers. Send the file as multipart data.

Important: This endpoint only works with loyalty programs with advanced tiers (with expiration and downgrade policy) feature enabled.

The CSV file should contain the following columns: - subledgerid (optional): The ID of the subledger. If this field is empty, the main ledger will be used. - customerprofileid: The integration ID of the customer profile to whom the tier should be assigned. - tiername: The name of an existing tier to assign to the customer. - expirydate: The expiration date of the tier. It should be a future date.

About customer assignment to a tier: - If the customer isn't already in a tier, the customer is assigned to the specified tier during the tier import. - If the customer is already in a tier, the customer is assigned to match the new information provided in the CSV file. - If the customer is already in the tier that's specified in the CSV file, only the expiration date is updated.

You can use the time zone of your choice. It is converted to UTC internally by Talon.One.

Note: We recommend limiting your file size to 500MB.

Example: csv subledgerid,customerprofileid,tiername,expirydate SUB1,alexa,Gold,2024-03-21T07:32:14Z ,george,Silver,2025-04-16T21:12:37Z SUB2,avocado,Bronze,2026-05-03T11:47:01Z

Request Body

[{"name"=>"upFile", "value"=>"velit", "datatype"=>"string"}]

HEADERS