---
title: "Create user"
method: POST
path: "/api/v1/user/create"
tags: ["General.User"]
---

# Create user

`POST /api/v1/user/create`

Creates a user and its user profile and returns the ID of the created user

## Request body

- GeneralUserCreateUser — Create user request body
  - `external_user_id` string — Optional external user ID for the created user.
  - `locale` string — Locale for the user. Defaults to default locale for the user's market.
  - `market` string, required — Market specific code for the user as a ISO 3166-1 country code.
  - `retention_class` string — [BETA] Determines whether Tink will retain the user until explicitly deleted, or automatically delete the user after 24 hours. Set with either "permanent" or "temporary". Defaults to the <a href="https://docs.tink.com/glossary#permanent-users:~:text=our%20guide.-,Permanent%20users,-A%20Tink%20User">user retention setting for your app</a>.

## Response `200`

The user was successfully created and returned.

- GeneralUserCreateUserResponse — Create user response body
  - `external_user_id` string, required — The external user ID of the created user.
  - `user_id` string, required — The user ID of the created user.

## Other responses

- `400` — The input market and/or locale was invalid.
- `409` — User with the same external id already exists.

---

[API](https://skmtc.net/tink/apis/tink-api.md) · [All operations](https://skmtc.net/tink/apis/tink-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tink/tink-api/revisions/23d8982b533d/schema)