---
title: "Identify a user"
method: POST
path: "/identify"
tags: ["v2.0"]
---

# Identify a user

`POST /identify`

Associate one or more identities with a Permutive user, allowing you to identify users in multiple ways.

## Request body

- IdentifyUser
  - `user_id` string, uuid, required — The Permutive user ID currently assigned to the user.
  - `aliases` PrioritizedAlias[], required — A list of prioritized aliases that the user is associated with. If no aliases are provided, the user ID will be returned.
    - `priority` integer, required — The priority of the alias, where `0` is the highest priority.
    - `tag` string, required — The tag is a string used to identify the type of alias, e.g. `email_sha256` or `myInternalID`.
    - `id` string, required — The identifier for the alias, e.g. `user@example.com` or `1234567890`.

## Response `200`

Resolved identity

- ResolvedIdentity
  - `user_id` string, uuid — The resolved user ID.

## Other responses

- `401` — Unauthorized request: invalid or missing API key
- `500` — Internal server error: unexpected error

---

[API](https://skmtc.net/permutive/apis/custom-cohort-segmentation-api.md) · [All operations](https://skmtc.net/permutive/apis/custom-cohort-segmentation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/permutive/custom-cohort-segmentation-api/versions/9fb06b4e8a44/schema)