---
title: "Adds identities to the subscription"
method: POST
path: "/subscription/addIdentity"
tags: ["Subscription Service"]
---

# Adds identities to the subscription

`POST /subscription/addIdentity`

Adds identities and associates them with a subscriptionId, while overwritting the previously added identities

## Request body

- SubscriptionIdentitiesRequest
  - `subscriptionId` string, required — Id associated with a user's stored payments
  - `identities` CustomerIdentity[], required — Identities that will be associated with SubscriptionId
    - `identityTypeId` 0 | 1 | 2 | 3 | 4, required — Valid values: 1=SSN, 2=Passport, 4=Alien Registration Number for Identity One; 0=Other, 3=Driver’s License for Identity Two
    - `value` string, required — The identity's value
    - `countryCode` string, required — Country code
    - `region` string — (optional for SSN, Passport, and Alien Registration Number; required for Driver's license and Other)Region/state code

## Response `200`

Identities added

- SubscriptionResponse
  - `subscriptionId` string — Id associated with a user's stored payments
  - `storedPaymentMethodId` string — Identifies a specific stored payment
  - `httpStatusCode` integer — Http status code
  - `message` string — Success message
  - `responseTimestamp` string, date-time — Date of response

## Other responses

- `400` — Invalid input data
- `401` — Unauthorized. The access token is missing, invalid, or expired.
- `500` — Internal server error

---

[API](https://skmtc.dev/civikestpayment/apis/pays-service-api-specifications.md) · [All operations](https://skmtc.dev/civikestpayment/apis/pays-service-api-specifications/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/civikestpayment/pays-service-api-specifications/revisions/e94a116dff94/schema)