---
title: "Create partner sub-account"
method: POST
path: "/profiles/partner-accounts"
tags: ["Partner Accounts"]
---

# Create partner sub-account

`POST /profiles/partner-accounts`

Creates a new sub-account linked to the authenticated partner. Requires HMAC authentication with the `account_creation` scope.

**Server wallet mode** (`createServerWallet: true`): Creates a Privy server wallet and profile. The partner can then submit orders on behalf of this account using delegated signing.

**EOA mode** (default): Requires wallet ownership verification via `x-account`, `x-signing-message`, and `x-signature` headers. The end user signs their own orders.

## Headers

- `x-account` string
- `x-signing-message` string
- `x-signature` string

## Request body

- CreatePartnerAccountRequest
  - `displayName` string — Public display name for the sub-account. Defaults to the wallet address if omitted.
  - `createServerWallet` boolean — If true, creates a Privy server wallet for the sub-account (enables delegated signing). If false or omitted, requires EOA wallet ownership headers.

## Response `201`

Sub-account created

- CreatePartnerAccountResponse
  - `profileId` integer, required — Profile ID of the created sub-account
  - `account` string, required — Wallet address of the created sub-account

## Other responses

- `400` — Cannot create a partner account for the partner's own address, or profile creation failed
- `401` — Wallet ownership verification failed (EOA mode)
- `403` — Requires apiToken auth with account_creation scope
- `409` — A profile already exists for this address

---

[API](https://skmtc.net/limitless-labs-group/apis/limitless-exchange-api.md) · [All operations](https://skmtc.net/limitless-labs-group/apis/limitless-exchange-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/limitless-labs-group/limitless-exchange-api/revisions/f60847044e0d/schema)