Skip to main content
POST
Create a business entity

Authorizations

api_key
string
header
required

Program API key identifying your integration. Pass as the api_key HTTP header (preferred) or as an api_key field in the JSON request body. Required on every request in addition to the HMAC Authorization header.

Body

application/json
user_id
string
required

Identifier of the representative user. Required.

Example:

"user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef"

business_name
string
required

Legal business name.

email
string<email>
required

Primary email address for the business.

Example:

"jane.doe@example.com"

phone_number
string
required

Phone number in E.164 format.

Example:

"+12125551234"

business_address
string
required

Business onboarding field: business address.

business_industry
string
required

Business onboarding field: business industry.

country
string
required

ISO 3166-1 alpha-2 country code.

state
string
required

ISO 3166-2 two-letter state/region code.

city
string
required

City.

incorporated_date
string
required

Business onboarding field: incorporated date.

incorporated_state
string
required

Business onboarding field: incorporated state.

api_key
string

Program API key. Accepted either in the api_key HTTP header or as this body field.

name
string

Optional display name. Defaults to business_name when omitted.

business_email
string

Business onboarding field: business email.

business_phone
string

Business onboarding field: business phone.

business_phone_number
string

Business onboarding field: business phone number.

support_email
string

Business onboarding field: support email.

support_phone_number
string

Business onboarding field: support phone number.

website
string

Business onboarding field: website.

business_address_2
string

Business onboarding field: business address 2.

naics_code
string

Business onboarding field: naics code.

business_type
string

Business onboarding field: business type.

zipcode
string

5-digit US ZIP code.

business_description
string

Business onboarding field: business description.

ein
string

Business onboarding field: ein.

Business onboarding field: logo.

Business onboarding field: business logo.

ach_engine
string

Business onboarding field: ach engine.

business_rep_name
string

Legal name of the business representative.

business_rep_email
string

Business onboarding field: business rep email.

business_rep_job_title
string

Business onboarding field: business rep job title.

business_rep_dob
string

Business onboarding field: business rep dob.

business_rep_address
string

Business onboarding field: business rep address.

business_rep_address_2
string

Business onboarding field: business rep address 2.

business_rep_zipcode
string

Business onboarding field: business rep zipcode.

business_rep_city
string

Business onboarding field: business rep city.

business_rep_phone
string

Business onboarding field: business rep phone.

business_rep_ssn
string

Business onboarding field: business rep ssn.

business_rep_website
string

Business onboarding field: business rep website.

business_rep_country
string

Business onboarding field: business rep country.

business_rep_state
string

Business onboarding field: business rep state.

delivery_fufilment
string

Business onboarding field: delivery fufilment.

support_address_one
string

Business onboarding field: support address one.

support_address_two
string

Business onboarding field: support address two.

support_country
string

Business onboarding field: support country.

support_city
string

Business onboarding field: support city.

support_zipcode
string

Business onboarding field: support zipcode.

support_state
string

Business onboarding field: support state.

business_proof
string

Business onboarding field: business proof.

personal_id
string

Business onboarding field: personal id.

send_email_notification
string

Business onboarding field: send email notification.

otp
string

Business onboarding field: otp.

security
string

Business onboarding field: security.

meta_data
object[]

List of {name, value} pairs to persist alongside the entity.

Response

Success.

status
enum<string>
required
Available options:
success
message
string
required
Example:

"operation completed"

data
object

Endpoint-specific payload; shape varies per operation.