Skip to content
Select themeSelect language

`POST /api/marketplace/seller/profile` — create the authenticated user's seller profile. One profile per user (unique constraint on `user_id`).

POST
/api/marketplace/seller/profile
curl --request POST \
--url https://example.com/api/marketplace/seller/profile \
--header 'Content-Type: application/json' \
--data '{ "display_name": "example", "payout_method": "example", "provider": "example", "provider_kind": "example", "support_email": "example", "website_url": "example" }'
Media typeapplication/json
object
display_name
required
string
payout_method
string | null
provider
string | null
provider_kind
string | null
support_email
string | null
website_url
string | null
Examplegenerated
{
"display_name": "example",
"payout_method": "example",
"provider": "example",
"provider_kind": "example",
"support_email": "example",
"website_url": "example"
}
Media typeapplication/json

A seller profile — one per user. Tracks payment provider on-boarding status (charges_enabled, payouts_enabled) and the chosen payout method. provider_kind distinguishes pure sellers from runner providers.

object
charges_enabled
required
boolean
created_at
required
string format: date-time
display_name
required
string
id
required
string format: uuid
payout_method
required
string
payouts_enabled
required
boolean
provider
required
string
provider_account_id
string | null
provider_kind
required
string
requirements
required
support_email
string | null
terms_accepted_at
string | null format: date-time
updated_at
required
string format: date-time
user_id
required
string format: uuid
website_url
string | null
Examplegenerated
{
"charges_enabled": true,
"created_at": "2026-04-15T12:00:00Z",
"display_name": "example",
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"payout_method": "example",
"payouts_enabled": true,
"provider": "example",
"provider_account_id": "example",
"provider_kind": "example",
"requirements": "example",
"support_email": "example",
"terms_accepted_at": "2026-04-15T12:00:00Z",
"updated_at": "2026-04-15T12:00:00Z",
"user_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"website_url": "example"
}