crate::account::agreement::controller::openapi_v2::signatures1

crate::account::identity::controller::openapi::business::accounts9

crate::account::identity::controller::openapi::individual::accounts1

crate::connectivity::controller::openapi::deposit_instructions5

crate::connectivity::controller::openapi::withdrawals3

crate::connectivity::fiat::controller::openapi::external_accounts5

crate::connectivity::fiat::controller::openapi::fiat_deposit_accounts1

crate::connectivity::fiat::controller::openapi::virtual_accounts7

crate::trading::controller::openapi::conversions3

crate::transaction::compliance::rfi::controller::openapi4

crate::transaction::compliance::rfi::controller::preflight1

crate::transaction::history::controller::openapi::transactions2

crate::transaction::instruction::controller::openapi::auto_conversion_rule7

crate::transaction::ledger::controller::openapi::assets1

crate::transaction::ledger::controller::openapi::transfers3

crate::transaction::pricing::controller::openapi::fees1

crate::transaction::pricing::controller::openapi::partner_fee_routes5

crate::web::openapi::recipients12

crate::web::openapi::simulations1

Webhook recovery6

crate::account::identity::controller::openapi::business::accounts

POST /v2/accounts/{main_account_id}/businesses

Changed on Nov 3, 2026

Request

Base URL
https://api.1money.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/1money/apis/1money-openapi/docs/v2/accounts/:main_account_id/businesses/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

main_account_idstring required

Parent account id — the MAIN or an approved business sub-account under your account, in the form BZ-XXXX-XXXX.

Headers

Idempotency-Keystring nullable

Optional idempotency key for this business onboarding create request.

Request body

legal_namestring required

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

trading_namestring nullable

Name the business trades under when it differs from its registered legal name (optional). Maximum 100 characters.

external_idstring nullable

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.

descriptionstring nullable

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

business_emailstring required

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

websitestring nullable

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

Example request

{
  "legal_name": "Acme Corporation",
  "trading_name": "Acme Coffee",
  "external_id": "ext-1234",
  "business_email": "contact@acme.com",
  "website": "https://acme.com",
  "registration": {
    "incorporated_at": "2020-01-15",
    "address": {
      "street_line_1": "123 Main Street",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94102"
    },
    "tax_id": "12-3456789"
  },
  "operating_address": {
    "street_line_1": "123 Main Street",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94102"
  },
  "controllers": [
    {
      "first_name": "John",
      "last_name": "Smith",
      "email": "john.smith@acme.com",
      "dob": "1980-01-15",
      "residential_address": {
        "street_line_1": "123 Main Street",
        "city": "San Francisco",
        "state": "CA",
        "postal_code": "94102"
      },
      "tax_info": {
        "number": "12-3456789"
      },
      "identification": {
        "id_number": "A12345678"
      }
    }
  ],
  "intermediaries": [
    {
      "entity_name": "Global Holdings Ltd"
    }
  ],
  "terms": [
    {
      "signed_at": "2026-03-17T15:04:05Z",
      "signature_id": "8e55f5a7-6f66-4a1f-b104-f90b2c8af5df"
    }
  ]
}

Response

Business account created successfully.

account_idstring required

parent_account_idstring required

external_idstring nullable

Partner-supplied identifier for the business in the partner's own system.

legal_namestring required

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

trading_namestring nullable

Name the business trades under when it differs from its registered legal name.

descriptionstring nullable

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

business_emailstring required

Primary contact email for the business.

websitestring nullable

Public website of the business.

submitted_atstring nullable

Timestamp at which the sub-account was last submitted for compliance review (RFC 3339 format). null while the sub-account is still in initial onboarding.

created_atstring required

Timestamp at which the sub-account was initiated (RFC 3339 format).

updated_atstring required

Timestamp of the most recent update to the sub-account or any of its related entities (RFC 3339 format).

deleted_atstring nullable

Timestamp at which the customer was deleted. null for active customers.

Example response

{
  "external_id": "ext-1234",
  "registration": {
    "incorporated_at": "2020-01-15",
    "address": {
      "street_line_1": "123 Main Street",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94102"
    },
    "tax_id": "12-3456789"
  },
  "operating_address": {
    "street_line_1": "123 Main Street",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94102"
  },
  "controllers": [
    {
      "residential_address": {
        "street_line_1": "123 Main Street",
        "city": "San Francisco",
        "state": "CA",
        "postal_code": "94102"
      },
      "tax_info": {
        "number": "12-3456789"
      },
      "identification": {
        "id_number": "A12345678"
      }
    }
  ],
  "intermediaries": [
    {
      "id": "IT-ABCD-1234"
    }
  ],
  "terms": [
    {
      "url": "https://www.1money.com/legal-and-privacy/privacy-policy",
      "name": "Privacy Policy"
    }
  ],
  "errors": [
    {
      "type": "FIELD_VALIDATION",
      "description": "Invalid value for field 'industry'.",
      "target": {
        "scope": "BUSINESS",
        "data": {
          "controller_id": "8d3e45fa-b76c-45e2-abd1-aa9d29d20964",
          "intermediary_id": "0c8b9d1e-3f4a-4b2c-9d8e-1a2b3c4d5e6f",
          "property": "industry",
          "document_type": "CERT_OF_INC"
        }
      }
    }
  ],
  "deleted_at": "2026-08-31T12:30:00Z"
}

Changes

Nov 3, 2026d213edbaccb6 Revision changes
- breaking
  added subschema #2 to the request property allOf list
- breaking
  the request property became required
- breaking
  the request property / became required
- breaking
  the request property / became required
- breaking
  removed the enum value FUND of the request property /
- breaking
  removed the enum value MAJORITY_OWNED_SUBSIDIARY_OF_FI_OR_NBFI of the request property /
- breaking
  removed the enum value MAJORITY_OWNED_SUBSIDIARY_OF_PUBLICLY_LISTED_COMPANY of the request property /
- breaking
  removed the enum value OWNED_BY_TRUST of the request property /
- breaking
  removed the enum value PRIVATELY_OWNED of the request property /
- breaking
  removed the enum value PUBLICLY_LISTED_COMPANY of the request property /
- breaking
  removed the enum value WHOLLY_OWNED_SUBSIDIARY_OF_FI_OR_NBFI of the request property /
- breaking
  removed the enum value WHOLLY_OWNED_SUBSIDIARY_OF_PUBLICLY_LISTED_COMPANY of the request property /
- breaking
  the request property's minItems was increased to 1
- breaking
  the / request property's minItems was increased to 1
- breaking
  the / request property's minItems was increased to 1
- breaking
  the request property type changed from object to no type
- breaking
  the / request property type changed from string to no type
- breaking
  the response property ///// became optional for the status
- breaking
  added to the response property oneOf list for the response status
- breaking
  added subschema #1 to the ///// response property oneOf list for the response status
- breaking
  the response's property type changed from no type to string for status
- breaking
  the response's property type changed from no type to string for status
- breaking
  the ///// response's property type changed from string to no type for status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- warning
  removed the request property
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  added the new ADVERTISING_MARKETING_PR enum value to the //// response property for the response status
- warning
  added the new ART_ANTIQUITIES_DEALERS enum value to the //// response property for the response status
- warning
  added the new BQ enum value to the ////// response property for the response status
- warning
  added the new BQ enum value to the /////// response property for the response status
- warning
  added the new BQ enum value to the ////// response property for the response status
- warning
  added the new BQ enum value to the /////// response property for the response status
- warning
  added the new BQ enum value to the /////// response property for the response status
- warning
  added the new BQ enum value to the // response property for the response status
- warning
  added the new BQ enum value to the ////// response property for the response status
- warning
  added the new CHARITIES_NON_PROFIT enum value to the //// response property for the response status
- warning
  added the new COMMODITY_TRADING enum value to the //// response property for the response status
- warning
  added the new COMPANY_FORMATION_TCSP enum value to the //// response property for the response status
- warning
  added the new FREIGHT_FORWARDING enum value to the //// response property for the response status
- warning
  added the new IMPORT_EXPORT_TRADE_FINANCE enum value to the //// response property for the response status
- warning
  added the new PAYROLL_PEO_EOR enum value to the //// response property for the response status
- warning
  added the new RESIDENCE_PERMIT enum value to the /////// response property for the response status
- info
  api tag crate::account::identity::controller::openapi::business::accounts added
- info
  api tag Onboarding V2 removed
- info
  added the new optional header request parameter Idempotency-Key
- info
  added the new optional request property /
- info
  added the new optional request property
- info
  the request property / became optional
- info
  the request property default value PRIVATELY_OWNED was added
- info
  added the new ADVERTISING_MARKETING_PR enum value to the request property
- info
  added the new ART_ANTIQUITIES_DEALERS enum value to the request property
- info
  added the new BQ enum value to the request property //////
- info
  added the new BQ enum value to the request property ///
- info
  added the new BQ enum value to the request property //
- info
  added the new BQ enum value to the request property ///
- info
  added the new BQ enum value to the request property ///
- info
  added the new BQ enum value to the request property //
- info
  added the new BQ enum value to the request property //
- info
  added the new CHARITIES_NON_PROFIT enum value to the request property
- info
  added the new COMMODITY_TRADING enum value to the request property
- info
  added the new COMPANY_FORMATION_TCSP enum value to the request property
- info
  added the new FREIGHT_FORWARDING enum value to the request property
- info
  added the new IMPORT_EXPORT_TRADE_FINANCE enum value to the request property
- info
  added the new PAYROLL_PEO_EOR enum value to the request property
- info
  added the new RESIDENCE_PERMIT enum value to the request property ///
- info
  added subschema #1 to the / request property oneOf list
- info
  added the optional property //// to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property to the response with the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property ///// became required for the status
- info
  the response property ///// became required for the status
- info
  the response's property default value PRIVATELY_OWNED was added for the status
- info
  removed the FUND enum value from the ///// response property for the response status
- info
  removed the MAJORITY_OWNED_SUBSIDIARY_OF_FI_OR_NBFI enum value from the ///// response property for the response status
- info
  removed the MAJORITY_OWNED_SUBSIDIARY_OF_PUBLICLY_LISTED_COMPANY enum value from the ///// response property for the response status
- info
  removed the OWNED_BY_TRUST enum value from the ///// response property for the response status
- info
  removed the PRIVATELY_OWNED enum value from the ///// response property for the response status
- info
  removed the PUBLICLY_LISTED_COMPANY enum value from the ///// response property for the response status
- info
  removed the WHOLLY_OWNED_SUBSIDIARY_OF_FI_OR_NBFI enum value from the ///// response property for the response status
- info
  removed the WHOLLY_OWNED_SUBSIDIARY_OF_PUBLICLY_LISTED_COMPANY enum value from the ///// response property for the response status
- info
  removed subschema #1 from the response property oneOf list for the response status
- info
  removed subschema #1 from the response property oneOf list for the response status
- info
  removed from the response property oneOf list for the response status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history