Update a Loyalty Member with Trueloyal Generated ID

post

https://api.zinrelo.com/v2/loyalty/members/{id}

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

Defaults to 62d6439adfa6b74ab18eb1a6

Add Zinrelo generated ID.

Query Params

language

string

One of the store languages, for example english/ italian/ german, etc.

Body Params

member_id

string

Enter the member ID.

Tags, email address and custom attributes from the new account will take precedence during the merge.

Any transactions associated with the current member will be transferred to the account corresponding to the new Member ID.

first_name

string

First name of the loyalty member.

Please Note: The first name should be less than 100 characters.

last_name

string

Last name of the loyalty member.

Please Note: The last name should be less than 100 characters.

email_address

string

Email address of the loyalty member.

phone_number

string

Phone number of the loyalty member. Format : [COUNTRY CODE - PHONE NUMBER] E.g : 91-9960654555 COUNTRY CODE defaults to +1

birthdate

string

Birthdate of the loyalty member. Format : <MM/DD/YYYY>

Note: Our API records all date and time fields in UTC time.

anniversary_date

string

Wedding anniversary date of the loyalty member. Format : <MM/DD/YYYY>

Note: Our API records all date and time fields in UTC time.

preferred_language

string

Enter your preferred language.

twitter_handle

string

Twitter username of the loyalty member.

instagram_handle

string

Instagram username of the loyalty member.

address

object

Address of the loyalty member. Child Parameters are as follows:

referral_code

string

If a member used a referral code shared by a friend, which you may have captured in the user registration form, you may pass it in referral_code to let Zinrelo identify the friend who referred this member.

member_tags

array of strings

List of tags that you’d want to tag this member with.

IMPORTANT: Updating the member tags will wipe out the existing tags and add the new array of tags. If you wish to append the new tag to an existing list, please make sure you retrieve the existing tags first , add the new tag to this list of existing tags and then make the update API call.

member_tags

email_subscription_status

string

Values can be ‘subscribed’ or ‘unsubscribed’ . If ‘unsubscribed’, this member will not receive any email notifications triggered by Zinrelo.

member_status

string

Accepted values in the request are ‘active’ , ‘blocked’, ‘opted_out’. Default is ‘active’. ‘active’ member is the one accumulating loyalty points and has access to rewards and earning opportunities. ‘blocked’ member is prohibited from participating in the program. ‘opted_out’ member is the one who has chosen to opt out of the loyalty program.

opted_out and/or blocked members can become active by passing member_status as 'active'.

current_tier_id

string

The ID of the tier to which the member should be assigned.

IMPORTANT:

If the tier that you want to assign this member to is lower than the member’s existing tier (Tier downgrade scenario), the next time the member earns points, Zinrelo will recalculate the qualified points to check whether the member is eligible for a tier upgrade. If the tier that you want to assign this member to, is higher than the member’s existing tier (Tier Upgrade scenario), the next time this member is penalized by means of a ‘Deduct’ transaction, Zinrelo will recalculate the qualified points to check whether the member has enough points to be on the higher tier or else, this member will be downgraded.

If you have period based tiers, at the end of every interval, Zinrelo will check whether the member has enough qualified points to be on a certain tier. If a member does not have enough qualified points, they will be downgraded.

custom_attributes

json

Apart from the above parameters, you can also update the custom attributes that you would have already defined. Let’s assume, you had defined a new group called - Demographics Info (demographics_info) and education, nationality, religion as the custom attributes in the group and you wish to update the nationality, you can update it as follows:

“custom_attributes”: { “nationality” : “USA” }

Note: Only the parameters/attributes that you pass in the API request will be updated.

Responses

200200

400400