{ "error": "validation_failed", "fields": [ { "field": "taxId", "code": "compliance_tax_id_format", "message": "taxId format is invalid for US", "legacy": "compliance_tax_id_format:US" } ]}
Creates a business profile on your account. Only name is required — you can create a draft and fill it in later. When the profile carries a complete identity (companyLegalName, taxId, addressCountry, businessContactFirstName, businessContactLastName) and addressCountry is US, KYB verification starts automatically. For any other country, the profile stays unverified: once it carries companyLegalName, taxId, and addressCountry, uploading a supporting document moves it to admin review instead of automated KYB.For a US profile, submission is asynchronous, so this response still reports verificationStatus: "unverified"; it moves to pending shortly after, once the submission is accepted. Poll Get Business Profile or subscribe to the business_profile.* webhooks rather than reading the outcome off the create response.
Requires a live key. This endpoint is idempotent: send an Idempotency-Key header to make retries safe.
A complete legal identity is unique within the account. A duplicate create returns 409 business_identity_exists and businessProfileId; fetch that existing business and confirm its current revision on the number request. The API does not silently merge profiles or start a second paid verification for the duplicate.
Body Parameters
string
required
Profile label (distinct from the brand name — an account can hold several profiles). Max 100 characters.
string
account_business for your account’s legal entity or client_business for a client you represent. Once confirmed, the relationship is immutable.
string
Registered legal entity name, as it appears on IRS/registry records. For US TIN match, the sanitized name must be ≤ 40 characters.
string
EIN / TIN. Validated against addressCountry’s format; stored in its canonical form.
string
Type of value in taxId (e.g. ein, cbn, neq, provincial_number, registration_number). Auto-defaulted for countries with exactly one legal value; CA requires an explicit choice.
Authorized contact first name (required by the carrier registry at verification).
string
Authorized contact last name.
string
Street.
string
City.
string
State/region (coerced to a 2-letter code where applicable).
string
Postal code.
string
Brand name.
string
Business website URL.
string
Business contact email.
string
Industry / vertical.
Response Fields
object
The created profile (see Get Business Profile). verificationStatus is unverified in this response even when KYB was auto-submitted — the move to pending happens asynchronously. taxIdLast4 is returned in place of the full tax id.