For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/account/create-organization-user.md.
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.
bearerAuthAuthorizationBearer <JWT>An access token from POST /v1/auth/api-key/token. An organization token lasts one hour and has no refresh token; a personal token can be refreshed.
organization_id*stringYour 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.
uuidapplication/json- body
Creates or finds a user the organization trades for. Exactly one of signer_public_key or passkey is required.
external_ref_id*ExternalRefIdThe 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).
^[A-Za-z0-9_-]{1,64}$signer_public_key?stringTurnkey signer key, a 33-byte compressed P-256 point as 66 hex characters
passkey?A WebAuthn passkey registration, as returned by navigator.credentials.create.
The user already held wallets; the signer sent was not used
application/json- response
A user the organization trades for
user_id*stringuuidexternal_ref_id*ExternalRefIdThe 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).
^[A-Za-z0-9_-]{1,64}$created_at*stringdate-timewallets*array<>Empty only while the wallet step has not completed; re-send the create to finish it.
curl -X POST 'https://api.truemarkets.co/v1/account/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/users' \ -H 'Content-Type: application/json' \ -d '{ "external_ref_id": "string"}'{ "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5", "external_ref_id": "string", "created_at": "2019-08-24T14:15:22Z", "wallets": [ { "address": "string", "chain_family": "evm" } ]}List the users your organization trades for GET
Returns your organization's users, newest first. Page with the opaque cursor from pagination.next_cursor. Supply external_ref_id instead to look up a single user by the reference you created them with; a reference matching nothing is an empty page.
Get a user your organization trades for GET
Returns one of your organization's users, with the wallets held for them.