Initiate Business Account

post

https://api.1money.com/v2/accounts/{main_account_id}/businesses

Initiates the onboarding of a business sub-account

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Initiates a business sub-account under a Partner Main-Account.

The endpoint is called after the customer accepts 1Money's Terms of Service (passing the resulting signature_id or signed_at) and returns the documents required for the business and its controllers.

See the Business Onboarding Overview for the full onboarding flow.

Path Params

main_account_id

string

required

Main account id in the form BZ-XXXX-XXXX.

Body Params

Request body for initiating a business sub-account under a Partner Main-Account.

legal_name

string

required

Legal name of the business as registered with the relevant tax or company authority.

external_id

string | null

Partner-supplied identifier for the business in the partner's own system. Maximum 255 characters. Useful for cross-system reconciliation and for filtering via the List Business Accounts API.

description

string | null

Free-form description of the nature of the business and its activities.

type

string

enum

required

Legal form of the business being onboarded.

industry

string

enum

required

Industry in which a business primarily operates.

business_email

string

required

Primary contact email for the business. Must be a valid email address.

compliance_email

string | null

Optional dedicated compliance contact email. 1Money sends RFI and other compliance notifications to this address when set; falls back to business_email otherwise.

website

string | null

Public website of the business. Must be a valid absolute URL when provided.

registration

object

required

Incorporation details of the business — when and where the entity was registered.

operating_address

object

required

Primary operating address of the business, when it differs from the registered address.

profile

object

required

Compliance profile — account purpose, source of funds, expected activity, and ownership structure.

controllers

array of objects

Beneficial owners and control persons of the business. At least one controller must have profile.has_control = true.

controllers

intermediaries

array of objects

Intermediary entities such as parent companies or holding companies that sit in the ownership chain between the business and its ultimate beneficial owners.

intermediaries

terms

array of objects

Terms accepted by the customer. Each entry must include the term type and exactly one of signature_id (1Money-hosted flow) or signed_at (Partner-hosted flow). For the 1Money-hosted flow, send type: BUSINESS_ONBOARDING with the signature_id returned by the Create Terms of Service API. See the Business Onboarding Overview for details.

terms

Responses

201Business account created successfully.

400Bad Request

401Unauthorized

500Internal Server Error