---
title: "Add a new identity"
method: POST
path: "/members/{memberId}/identities"
tags: ["Member Identities"]
---

# Add a new identity

`POST /members/{memberId}/identities`

Add a new identity to a member profile. Returns 200 if it already exists on this member. Returns 409 if it already exists on another member.

## Path parameters

- `memberId` string, uuid, required

## Request body

- object
  - `value` string, required — Identity value (e.g. username, email address).
  - `platform` string, required — Platform name (e.g. github, linkedin).
  - `type` 'username' | 'email', required — Identity type.
  - `source` string, required — Source system that created this identity.
  - `verified` boolean, required — Whether the identity is verified.
  - `verifiedBy` string — Required when `verified` is true. Identifier of who verified.

## Response `201`

Identity created.

- MemberIdentity
  - `id` string, uuid, required
  - `value` string, required — Identity value (username or email).
  - `platform` string, required — Platform name (e.g. github, linkedin, lfid).
  - `type` 'username' | 'email', required — Identity type.
  - `verified` boolean, required
  - `verifiedBy` string, nullable, required — Identifier of who verified this identity, or null.
  - `source` string, nullable, required — Source system that created this identity.
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400` — Invalid request body or query parameters.
- `401` — Missing or invalid authentication credentials.
- `403` — Authentication valid but insufficient scopes.
- `404` — No member found with the given ID.
- `409` — Identity already exists on another member.

## Changes

- **2026-08-18** `08aceca4f417` — 1 breaking
  - the `verifiedBy` request property's minLength was increased from `0` to `1`
- **2026-05-11** `c4db8159d7d5` — 1 info
  - added the required property `type` to the response with the `201` status
- **2026-04-08** `4bd1bf1b8718` — 1 breaking
  - removed the required property `type` from the response with the `201` status

[Change history](https://skmtc.dev/linuxfoundation/apis/cdp-public-api/changes/members/:memberId/identities/post.md)

---

[API](https://skmtc.dev/linuxfoundation/apis/cdp-public-api.md) · [All operations](https://skmtc.dev/linuxfoundation/apis/cdp-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/linuxfoundation/cdp-public-api/revisions/08aceca4f417/schema)