Create a Loyalty Member API

Time	Status	User Agent
Retrieving recent requests…

Query Params

language

string

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

Body Params

member_id

string

required

Unique Identifier (Member ID) for the member object in the client’s system. Examples include “Customer ID”, “GUID”, “Email Address”, “Phone Number”

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. You will not be able to use Zinrelo"s in-built email notifications if this field is not set.

Note: Optional, if this is not marked as a unique field.

phone_number

string

Phone number of the loyalty member. Format : <+COUNTRY CODE - PHONE NUMBER> E.g : +1-7203332525 COUNTRY CODE defaults to +1

Note: Optional, if this is not marked as a unique field. REQUIRED if marked as unique.

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.

twitter_handle

string

Twitter username of the loyalty member.

preferred_language

string

Enter your preferred language.

instagram_handle

string

Instagram username of the loyalty member.

address

object

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

referrer_code

string

If a member has used a referral code shared by a friend, which you may have captured in the user registration form, you may pass it in referrer_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. Default value is ‘subscribed’.

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.

current_tier_id

string

The ID of the tier the member should be assigned.

custom_attributes

json

Apart from the above parameters, you can also pass in custom attributes that you want Zinrelo to associate with this member. You will first need to define the custom member attributes and then use the internal IDs in the API to pass the data. All the custom attributes will have to be passed in a dictionary called "custom_attributes" . "For e . g - Let"s assume you define a new group called - Demographics Info and education, nationality, religion as the custom attributes in that group, the new dictionary that you can pass in the API is as follows:
“custom_attributes”: {"wishlist" : ["shirt", "t-shirt"], "preferred stores" : ["USA", "France"] }

200200

400400