latestOpenAPI 3.1.02026-08-218667571.2 MB

a8ca30023371

Admin APIs
clients

Create Client

Create a new client with audit field. Whenever a client is created, a default wallet is also created. This is done based on logic in models/events/account.py. This also assigns provider access to the client based on logic in models/events/provider.py, which depends on the client compliance managed status and provider properties.

Address validation is performed via stripe.tax.Calculation.create() before the client is persisted. This creates a lightweight Calculation record in the Stripe dashboard on every attempt (Stripe has no dry-run mode for this API). The records carry no financial impact and are not tied to a customer, but will be visible in the Stripe audit trail.

Args: client: ClientCreate user_email: str

post/api/v1/admin/clients

Request body

skip_stripe_validationboolean

Response

Successful Response

keystring required
namestring required
idstring uuid4 required
client_idstring required
extra_infoobject nullable required
is_activeboolean required
tag_idsstring[] required
client_type_idstring uuid4 nullable
sectorstring nullable
is_compliance_managedboolean nullable
is_distributorboolean nullable
account_manager_emailstring email nullable
entity_idsstring[]
industry_idsstring[]
block_compliance'managed' | 'notified' | 'disabled' nullable
plan_tierstring required
transaction_limitnumber nullable
group_idsstring[] nullable
bill_to_emailstring email nullable
bill_to_namestring nullable
payment_method'card' | 'ach' | 'invoice' nullable
stripe_customer_idstring nullable
current_consumptionnumber nullable
address_line_1string nullable
address_line_2string nullable
citystring nullable
statestring nullable
zipstring nullable
countrystring nullable
data_collection_consent_restrictedboolean
mcp_provider_access_follows_apiboolean
block_sample_access_follows_liveboolean
exchange_enabledboolean
subscription_statusstring nullable
deleted_atstring date-time nullable
deletion_reasonstring nullable
created_atstring date-time required
plan_typestring nullable
distributor_client_idstring uuid4 nullable
distributor_namestring nullable