v32

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-076085232.1 KB

Partner Accounts

Create partner sub-account

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.

post/profiles/partner-accounts

Headers

x-accountstring

EOA mode only. Checksummed Ethereum address of the sub-account wallet.

x-signing-messagestring

EOA mode only. Hex-encoded signing message.

x-signaturestring

EOA mode only. Hex-encoded signature from the sub-account wallet.

Request body

displayNamestring

Public display name for the sub-account. Defaults to the wallet address if omitted.

createServerWalletboolean

If true, creates a Privy server wallet for the sub-account (enables delegated signing). If false or omitted, requires EOA wallet ownership headers.

Example request

{
  "displayName": "user-alice"
}

Response

Sub-account created

profileIdinteger required

Profile ID of the created sub-account

accountstring required

Wallet address of the created sub-account

Example response

{
  "profileId": 789,
  "account": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed"
}