---
title: "Add Profile Identifier"
method: POST
path: "/v1/Stores/{storeId}/Profiles/{profileId}/Identifiers"
tags: ["Identifiers"]
---

# Add Profile Identifier

`POST /v1/Stores/{storeId}/Profiles/{profileId}/Identifiers`

## Request

- Base URL: `https://memory.twilio.com`
- URL: `https://memory.twilio.com/v1/Stores/{storeId}/Profiles/{profileId}/Identifiers`
- Auth: HTTP basic

Asynchronously attach a new identifier value to a profile. When multiple values exist for an `idType`, ordering, limits, and uniqueness checks are enforced by the corresponding identifier settings `limitPolicy` and  reflect any normalization. If the identifier already exists and points to another profile, resolution rules or merge processes may apply. Use the identifier specific endpoint to inspect, update, or remove existing values.

## Request body

- Identifier: Represents a single identifier value paired with its `idType`. Write operations obey limits, uniqueness, and normalization rules configured via identifier settings.
  - `idType` string, required: Identifier type as configured in the service's Identity Resolution Settings.
  - `value` string, required: Raw value captured for the identifier. The service may normalize this value according to the `normalization` rule defined in the identifier settings before storage or matching (for example E.164 formatting for phone numbers).

## Response `202`

Identifier association accepted.

- object
  - `message` string, required

## Other responses

- `308`: This resource has moved.
- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: This error indicates that you have sent too many requests to the API. You should retry according to the `Retry-After` response header.
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

> 12 revisions in range; 1 not diffed.

- **2026-08-11** (v1) `b0ed05460bbf`: 7 breaking
  - the `code` response property's max was increased from `99999.00` to `999999.00` for the response status `400`
  - the `code` response property's max was increased from `99999.00` to `999999.00` for the response status `401`
  - the `code` response property's max was increased from `99999.00` to `999999.00` for the response status `403`
  - the `code` response property's max was increased from `99999.00` to `999999.00` for the response status `404`
  - …3 more

[Operation history](https://skmtc.dev/twilio/apis/memory-v1/changes/v1/Stores/:storeId/Profiles/:profileId/Identifiers/post.md)

---

[API](https://skmtc.dev/twilio/apis/memory-v1.md) - [All operations](https://skmtc.dev/twilio/apis/memory-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/memory-v1/revisions/1c9618b83dfd?raw)
