---
title: "Create a user ID"
method: POST
path: "/users"
tags: ["v2.0"]
---

# Create a user ID

`POST /users`

This endpoint generates a new user ID that can be used to identify a user within Permutive.

 When you're not using an SDK, and you're interacting with this endpoint directly, it is your responsibility to store a user's ID. This endpoint responds with a Permtive user ID that can be used to identify a user within Permutive, to be stored by the client.

## Response `200`

New user ID created

- NewUserId
  - `id` string, uuid — The newly generated Permutive 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)