---
title: "POST /members/{member_id}"
method: POST
path: "/members/{member_id}"
---

# POST /members/{member_id}

`POST /members/{member_id}`

## Request body

- UpdateMemberWithMemberIdRequestBody
  - `member_id` string — <p>Enter the member ID.</p> <p>Tags, email address and custom attributes from the new account will take precedence during the merge.</p> <p>Any transactions associated with the current member will be transferred to the account corresponding to the new Member ID.</p>
  - `first_name` string — <p>First name of the loyalty member.</p> <p><strong>Please Note:</strong> The first name should be less than 100 characters.</p>
  - `last_name` string — <p>Last name of the loyalty member.</p> <p><strong>Please Note:</strong> The last name should be less than 100 characters.</p>
  - `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 — <p>Birthdate of the loyalty member. Format : &lt;MM/DD/YYYY&gt;</p> <p><strong>Note:</strong> Our API records all date and time fields in UTC time.</p>
  - `anniversary_date` string — <p>Wedding anniversary date of the loyalty member. Format : &lt;MM/DD/YYYY&gt;</p> <p><strong>Note:</strong> Our API records all date and time fields in UTC time.</p>
  - `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` CreateMemberAddressObject
    - `city` string — Member's city.
    - `country` string — Member's country.
    - `line2` string — The member address.
    - `line1` string — The member address.
    - `state` string — Member's state.
    - `postal_code` string — Member's postal code.
  - `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` string[] — <p>List of tags that you&rsquo;d want to tag this member with.</p> <p><strong>IMPORTANT:</strong> 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.</p>
  - `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 — <p>Accepted values in the request are <strong>&lsquo;active&rsquo; , &lsquo;blocked&rsquo;, &lsquo;opted_out&rsquo;.</strong> Default is &lsquo;active&rsquo;. <strong>&lsquo;active&rsquo;</strong> member is the one accumulating loyalty points and has access to rewards and earning opportunities. <strong>&lsquo;blocked&rsquo;</strong> member is prohibited from participating in the program.<strong> &lsquo;opted_out&rsquo;</strong> member is the one who has chosen to opt out of the loyalty program.&nbsp;</p> <p><strong>opted_out</strong> and/or <strong>blocked </strong>members can become active by passing member_status as<strong> 'active'.</strong></p>
  - `current_tier_id` string — <p><span style="font-weight: 400;">The ID of the tier to which the member should be assigned.</span></p> <p><strong>IMPORTANT:&nbsp;</strong></p> <p><span style="font-weight: 400;">If the tier that you want to assign this member to is lower than the member&rsquo;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&rsquo;s existing tier (Tier Upgrade scenario), the next time this member is penalized by means of a &lsquo;Deduct&rsquo; 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.&nbsp;</span></p> <p><span style="font-weight: 400;">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.</span></p>
  - `custom_attributes` string, 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.

## Response `200`

200

- UpdateMemberWithMemberIdDataObject
  - `deprecated_fields` DeprecatedMemberFieldsObject — These are the deprecated fields in Zinrelo.
    - `user_id` string — This field is going to be deprecated soon. We highly recommend not to use this field.
  - `lifetime_points_earned` integer — The total points earned in a member's account since he joined the program.
  - `twitter_handle` string — The twitter handle of the member.
  - `revenue` integer — The total revenue earned by the member.
  - `lifetime_points_expired` integer — The total points expired from a member's account since he joined the program.
  - `last_modified_date` string — The most recent date on which a member's profile was updated.
  - `available_points` integer — The avaliable points of the member.
  - `pending_points` integer — The pending points of the member.
  - `last_name` string — The last name of the member.
  - `referral_URL` string — The unique referral url of the member.
  - `member_status` string — The current status of the member- ‘active’ , ‘blocked’, ‘opted_out’. ‘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.
  - `referral_code` string — The unique referral code of the member.
  - `email_address` string — The email address of the member.
  - `id` string — The internal ID generated by Zinrelo.
  - `first_name` string — The first name of the member.
  - `number_of_activities` string — Number of activities performed by a member.
  - `member_tags` string[] — The tags assocaited with a member.
  - `referrer_code` string — The coupon code assigned to the referee for referring the friend.
  - `tier_info` UpdateMemberWithMemberIdTierInfoObject
    - `current_period_start` string — The start date of the current tier cycle.
    - `tier_qualification_units` string — The total amount or points of qualifying activities performed.
    - `loyalty_tier_name` string — The name of the current tier.
    - `loyalty_tier_id` string — The unique tier ID stored in Zinrelo.
    - `current_period_end` string — The end date of current tier cycle.
    - `qualified_points` integer — The qualified points for tier calculation.
  - `custom_attributes` unknown
  - `referrer_ID` string — The unique transaction ID associated with the referee.
  - `first_purchase_date` string — The first purchase date of the member.
  - `lifetime_points_deducted` integer — The total points deducted from a member's account since he joined the program.
  - `phone_number` string — The phone number of the member.
  - `points_expiration_schedule` UpdateMemberWithMemberIdPointExpirationScheduleObject[]
    - `expiration_date` string — The expiration date of the available points.
    - `points` integer — The total number of points that will expire.
  - `instagram_handle` string — The instagram handle of the member.
  - `referrer_name` string — The name of the person who referred.
  - `aov` integer — The Average Order Value (AOV) is a metric used in business to determine the average total amount spent by customers in a single transaction or purchase. It's calculated by dividing the total revenue generated from sales by the total number of purchases made during a specific period.
  - `address` CreateMemberAddressObject
    - `city` string — Member's city.
    - `country` string — Member's country.
    - `line2` string — The member address.
    - `line1` string — The member address.
    - `state` string — Member's state.
    - `postal_code` string — Member's postal code.
  - `deleted_date` string — The date on which a member is deleted. In this case, the value will be null because it is a member creation API.
  - `last_purchase_date` string — The last purchase date of the member.
  - `lifetime_points_redeemed` integer — The total points redeemed from a member's account since he joined the program.
  - `preferred_language` string — The preferred language of the member.
  - `number_of_purchases` integer — The number of purchases made by a member.
  - `number_of_redemptions` integer — The number of redemptions made by a member.
  - `birthdate` string — Birthdate of the loyalty member. Expected date format: MM/DD/YYYY or MM/DD Irrespective of the year passed, 1904 will be set as a default value.
  - `anniversary_date` string — The anniversary date of the member. Expected date format: MM/DD/YYYY or MM/DD In case, where a year has not been passed the default year will be set as 1904.
  - `enrollment_date` string — The date on which the member joined the loyalty program.
  - `member_id` string — The unique identifier of the member defined by an Admin.
  - `email_subscription_status` string — The subscription status of the email. If ‘unsubscribed’, the member will not receive any email notifications triggered by Zinrelo. Default value is ‘subscribed’.

## Other responses

- `400` — 400

---

[API](https://skmtc.net/trueloyal/apis/admin-apis.md) · [All operations](https://skmtc.net/trueloyal/apis/admin-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trueloyal/admin-apis/versions/c12d3d379897/schema)
