---
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

## Changes

- **2026-04-02** `a826c41835eb` — 1 info
  - endpoint added
- **2026-04-01** `013070af066e` — 1 breaking
  - api path removed without deprecation
- **2026-04-01** `04cff5f472c6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/limitless-labs-group/apis/limitless-exchange-api/changes/profiles/partner-accounts/post.md)

---

[API](https://skmtc.dev/limitless-labs-group/apis/limitless-exchange-api.md) · [All operations](https://skmtc.dev/limitless-labs-group/apis/limitless-exchange-api/llms.txt) · [OpenAPI document](https://skmtc.dev/limitless-labs-group/apis/limitless-exchange-api/revisions/20e1fd747a5c?raw)