API ReferenceAccount

Update account

Update account profile and settings. Supports display_name, bio, avatar (file token from POST /v1/files), and ga_measurement_id.

Authentication

AuthorizationBearer

API key (lb_ prefix). Pass as: Authorization: Bearer lb_...

Request

This endpoint expects an object.
display_namestring or nullOptional<=100 characters
Seller name shown on product pages. Improves buyer trust and conversion. If not set, buyers see a generic seller label.
biostring or nullOptional<=500 characters
Short seller bio shown on product pages. Plain text. Helps buyers understand who they're buying from.
avatarstring or nullOptional

Avatar image file token from POST /v1/files. Replaces any existing avatar. Shown on product pages next to seller name.

ga_measurement_idstring or nullOptional

Google Analytics 4 Measurement ID (G-XXXXXXXXXX). Set to null to remove

notify_ordersboolean or nullOptional
Email me when I receive a new external order

Response

Successful Response
idstring
Unique identifier
emailstring
Account email address
has_avatarboolean

true if avatar image exists. Upload via POST /v1/files, set via PUT /v1/account.

planstring

Current plan tier. Values: free (15% fee), growth (5% fee), scale (3% fee).

fee_ratestring

Transaction fee rate as decimal string. Determined by plan: free=0.15, growth=0.05, scale=0.03. Applied as platform fee on each order.

billing_statusstring

Subscription billing status. active = payments current. past_due = payment failed, service continues during grace period. unpaid = grace period expired, listings may be blocked.

notify_ordersboolean
Whether seller receives email alerts for new external orders
statsobject
Account aggregate statistics.
readinessobject

Account operational readiness. operational is true when the account can sell. If false, actions lists what’s needed with kind (api/human), resolve details, and next points to the highest-priority action.

created_atdatetime
Time at which the account was created
object"account"

Object type identifier. Always account.

display_namestring or null
Seller name shown on product pages.
biostring or null
Short seller bio shown on product pages.
currencystring or null

Account currency (ISO 4217, lowercase). Set automatically from Stripe Connect. Cannot be changed after connection.

ga_measurement_idstring or null

Google Analytics 4 Measurement ID (G-XXXXXXXXXX). Set via PUT /v1/account. Injected on all your product pages and thank-you pages

Errors

401
Unauthorized Error
422
Unprocessable Entity Error