Sign in

v5

latestOpenAPI 3.1.02026-07-262421791.5 MB
profile

Create a business profile (V3)

Create a business profile and its authorized representative in a single request.

{% admonition type="info" %} This request accepts an optional field in the header, X-idempotence-uuid. This should be unique for each Profile you create. In the event that the request fails, you should use the same value again when retrying. If the X-idempotence-uuid header is not provided and a Profile already exists, then you will receive a response with an HTTP status code 409. {% /admonition %}

See Business Category for the list of valid firstLevelCategory and secondLevelCategory values.

post/v3/profiles/business-profile

Headers

X-idempotence-uuidstring uuid

Unique idempotency key for the request.

X-External-Correlation-Idstring uuid

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Request body

businessNamestring

Business name.

businessNameInKatakanastring nullable

Business name in Katakana (only for Japanese businesses).

businessFreeFormDescriptionstring

Business free form description. Required if companyType is OTHER. If this is not provided for an OTHER companyType, the profile should not be allowed to create a transfer. For the rest of the companyTypes, it is highly recommended to always provide the business' description, to avoid payment issues such as suspensions. Wise will send a request for information (RFI) if this detail is not provided.

registrationNumberstring

Business registration number.

acnstring nullable

Australian Company Number (only for Australian businesses).

abnstring nullable

Australian Business Number (only for Australian businesses).

arbnstring nullable

Australian Registered Body Number (only for Australian businesses).

companyType'LIMITED' | 'PARTNERSHIP' | 'SOLE_TRADER' | 'LIMITED_BY_GUARANTEE' | 'LIMITED_LIABILITY_COMPANY' | 'FOR_PROFIT_CORPORATION' | 'NON_PROFIT_CORPORATION' | 'LIMITED_PARTNERSHIP' | 'LIMITED_LIABILITY_PARTNERSHIP' | 'GENERAL_PARTNERSHIP' | 'SOLE_PROPRIETORSHIP' | 'PRIVATE_LIMITED_COMPANY' | 'PUBLIC_LIMITED_COMPANY' | 'TRUST' | 'OTHER'

Company legal form.

companyRole'OWNER' | 'DIRECTOR' | 'OTHER'

Role of person.

externalCustomerIdstring

An external reference identifier mapping the customer of this profile to your system.

actorEmailstring

Email of the actor.

firstLevelCategorystring

Category of the business.

secondLevelCategorystring

Secondary category of the business.

webpagestring

Business webpage. Required if companyType is OTHER. If this is not provided for an OTHER companyType, the profile should not be allowed to create a transfer. For the rest of the companyTypes, it is highly recommended to always provide the business' website, to avoid payment issues such as suspensions. Wise will send a request for information (RFI) if this detail is not provided.

Example request

{
  "businessName": "ABC Logistics Ltd",
  "businessFreeFormDescription": "Biz free form desc",
  "registrationNumber": "12144939",
  "companyType": "LIMITED",
  "companyRole": "OWNER",
  "address": {
    "addressFirstLine": "1 A road",
    "city": "London",
    "countryIso2Code": "gb",
    "countryIso3Code": "gbr",
    "postCode": "11111"
  },
  "externalCustomerId": "67890-biz-acct",
  "actorEmail": "biz-acct@abcl.com",
  "firstLevelCategory": "CONSULTING_IT_BUSINESS_SERVICES",
  "secondLevelCategory": "DESIGN",
  "operationalAddresses": [
    {
      "addressFirstLine": "1 A road",
      "city": "London",
      "countryIso2Code": "gb",
      "countryIso3Code": "gbr",
      "postCode": "11111"
    }
  ],
  "webpage": "https://abc-logistics.com",
  "businessRepresentative": {
    "firstName": "Oliver",
    "lastName": "Wilson",
    "preferredName": "Olivia",
    "address": {
      "addressFirstLine": "50 Sunflower Ave",
      "city": "Phoenix",
      "countryIso3Code": "usa",
      "postCode": "10025",
      "stateCode": "AZ"
    },
    "contactDetails": {
      "email": "o.wilson@example.com",
      "phoneNumber": "+3725064992"
    },
    "dateOfBirth": "1977-07-01"
  }
}

Response

Created business profile.