---
title: "Create a user your organization trades for"
url: https://docs.truemarkets.co/api/account/create-organization-user
description: "Creates the user your organization trades for under the reference you name them by, with their wallets, or returns the existing one. The wallets are seated with exactly one of your own signer key or a passkey; the passkey signs at Turnkey only and never signs the user in. Re-sending the same request is safe: a 503 means the wallet step did not finish, and repeating the request completes it. Once your organization reaches its user limit a new reference is refused, while re-sending an existing one still works. Use the returned user_id as the TM-On-Behalf-Of value on trading routes."
---

Docs index: https://docs.truemarkets.co/llms.txt

# Create a user your organization trades for

Creates the user your organization trades for under the reference you name them by, with
their wallets, or returns the existing one. The wallets are seated with exactly one of your
own signer key or a passkey; the passkey signs at Turnkey only and never signs the user in.
Re-sending the same request is safe: a 503 means the wallet step did not finish, and
repeating the request completes it. Once your organization reaches its user limit a new
reference is refused, while re-sending an existing one still works.
Use the returned `user_id` as the `TM-On-Behalf-Of` value on trading routes.

## Request

```
POST https://api.truemarkets.co/v1/account/organizations/{organization_id}/users
```

### Authentication

Bearer token in `Authorization`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `organization_id` | path | string (uuid) | yes | Your organization's id: the `tm.organization_id` claim of an organization token, also shown on the dashboard Overview. The token must be this organization's, or belong to one of its admins. |

### Body

`application/json`, required

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `external_ref_id` | string | yes | The reference the client names a served user by, unique within the organization. Compared exactly as sent, with no case or format normalisation, so send the same string every time (a UUID in one consistent case). |
| `signer_public_key` | string | no | Turnkey signer key, a 33-byte compressed P-256 point as 66 hex characters |
| `passkey` | object | no | A WebAuthn passkey registration, as returned by `navigator.credentials.create`. |
| `passkey.challenge` | string | yes | The challenge passed to `navigator.credentials.create` |
| `passkey.credential_id` | string | yes | The credential id, unpadded base64url |
| `passkey.client_data` | string | yes | The client data JSON, unpadded base64url |
| `passkey.attestation` | string | yes | The WebAuthn attestation object, unpadded base64url |

## Responses

Every error status returns the same body, described in [Errors](https://docs.truemarkets.co/developer-resources/errors.md).

### 200

The user already held wallets; the signer sent was not used

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `user_id` | string (uuid) | yes |  |
| `external_ref_id` | string | yes | The reference the client names a served user by, unique within the organization. Compared exactly as sent, with no case or format normalisation, so send the same string every time (a UUID in one consistent case). |
| `created_at` | string (date-time) | yes |  |
| `wallets` | array of object | yes | Empty only while the wallet step has not completed; re-send the create to finish it. |
| `wallets[].address` | string | yes |  |
| `wallets[].chain_family` | string, one of `evm`, `solana` | yes | The family of chains this address serves. An `evm` address is the same on every EVM chain (base, arbitrum, robinhood); a `solana` address serves solana. |

### 201

This call seated the user's wallets with the signer sent

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `user_id` | string (uuid) | yes |  |
| `external_ref_id` | string | yes | The reference the client names a served user by, unique within the organization. Compared exactly as sent, with no case or format normalisation, so send the same string every time (a UUID in one consistent case). |
| `created_at` | string (date-time) | yes |  |
| `wallets` | array of object | yes | Empty only while the wallet step has not completed; re-send the create to finish it. |
| `wallets[].address` | string | yes |  |
| `wallets[].chain_family` | string, one of `evm`, `solana` | yes | The family of chains this address serves. An `evm` address is the same on every EVM chain (base, arbitrum, robinhood); a `solana` address serves solana. |

### 400

Malformed organization id, external reference, signer public key or passkey

### 401

Unauthorized

### 403

Forbidden

### 409

The reference names a member of the organization

### 422

The organization has reached its user limit; contact support to raise it

### 500

Internal server error

### 503

Service unavailable; retry the same request
