---
title: "Add a Customer into a Tier"
method: POST
path: "/tier/{tierId}/membership"
tags: ["Tier Membership"]
deprecated: true
---

# Add a Customer into a Tier

`POST /tier/{tierId}/membership`

> **Deprecated.**

This API allows a customer's Loyalty Account to be given a Tier Membership.

## Path parameters

- `tierId` string, required

## Headers

- `X-EES-AUTH-CLIENT-ID` string, string, required
- `X-EES-AUTH-HASH` string, string, required
- `Accept-Encoding` '' | 'gzip' | 'deflate' | 'gzip,deflate'
- `X-EES-TRANSACTION-ID` string, string
- `X-EES-RETRY` string, string

## Request body

- TierMembershipCreateRequestEntity
  - `status` 'ACTIVE', required
  - `expiryDate` string — DateTime in ATOM format.
  - `tierBalancesResetDate` string — DateTime in ATOM format.
  - `accountIds` string[], required — An array of accountIds with which to link this Tier Membership.

## Response `201`

The Tier Membership entity which defines the current state of a customer's Tier Membership.

- TierMembershipEntity
  - `tierMembershipId` string, required — The unique ID for this Tier Membership. This will be a numeric string value of variable length.
  - `tierId` string, required — The ID for the Tier Membership to which the customer belongs. This will be a numeric string value of variable length.
  - `status` 'ACTIVE', required — The status of this Tier Membership.
  - `accountIds` string[], required
  - `balances` TierMembershipBalancesEntity, required
    - `transactions` integer — The value representing the Tier Membership Balance for a customer's Tier Membership relating to the number of Tier Membership Transactions completed.
    - `spend` integer — The value representing the Tier Membership Balance for a customer's Tier Membership relating to the Tier Membership Spend amount completed.
    - `points` integer — The value representing the Tier Membership Balance for a customer's Tier Membership showing the Tier Membership Points earned.
  - `expiryDate` string, required — DateTime in ATOM format.
  - `tierBalancesResetDate` string, required — DateTime in ATOM format.
  - `dateCreated` string, required — DateTime in ATOM format.
  - `lastUpdated` string, required — DateTime in ATOM format.

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Not Found.
- `415` — Unsupported Media Type
- `429` — Too Many Requests
- `500` — Server Error

---

[API](https://skmtc.net/eagleeye/apis/wallet-api.md) · [All operations](https://skmtc.net/eagleeye/apis/wallet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eagleeye/wallet-api/revisions/90a122bb14cc/schema)