v5

latestOpenAPI 3.1.02026-07-262421791.5 MB

profile

Create a business profile

It is required that you first create a personal profile with details of the authorized representative of the business. It is currently not possible to create a business profile without first creating a personal profile.

{% 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. If this happens, you can retrieve the profiles with the 'List profiles for a user account' API GET /v2/profiles. {% /admonition %}

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

post/v2/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).

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"
}

Response

Created business profile.

type'BUSINESS' required

Type of profile.

idinteger

Unique identifier for the profile.

publicIdstring

Publicly accessible identifier for the profile.

userIdinteger

The ID of the user associated with this profile.

emailstring

Primary email address for the business.

createdAtstring date-time

Timestamp when the profile was created (ISO 8601 format).

updatedAtstring date-time

Timestamp when the profile was last updated (ISO 8601 format).

currentState'HIDDEN' | 'VISIBLE' | 'DEACTIVATED'

Current status of this profile.

businessNamestring

Registered business name.

registrationNumberstring

Business registration number.

descriptionOfBusinessstring

Brief description of the business.

webpagestring

Business website URL.

companyTypestring

Type of company.

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

Role of the person managing the business profile.

businessFreeFormDescriptionstring

Free-form description of the business activities.

firstLevelCategorystring

Primary business category.

secondLevelCategorystring

Secondary business category.

fullNamestring

Full legal name of the business.

Example response

{
  "type": "BUSINESS",
  "id": 14599371,
  "publicId": "f0e9d8c7-b6a5-4321-fedc-ba9876543210",
  "userId": 9889627,
  "address": {
    "id": 36086782,
    "addressFirstLine": "24 Willow Creek Lane",
    "city": "Bristol",
    "countryIso2Code": "GB",
    "countryIso3Code": "gbr",
    "postCode": "BS1 6AE"
  },
  "email": "info@innovate-solutions.co.uk",
  "createdAt": "2024-03-10T09:00:00",
  "updatedAt": "2025-06-18T14:22:00",
  "currentState": "VISIBLE",
  "contactDetails": {
    "email": "contact@innovate-solutions.co.uk",
    "phoneNumber": "+441617891234"
  },
  "businessName": "Innovate Solutions Ltd",
  "registrationNumber": "SC1234567890ABCD",
  "descriptionOfBusiness": "SOFTWARE_DEVELOPMENT",
  "webpage": "https://www.innovate-solutions.co.uk",
  "companyType": "LIMITED_COMPANY",
  "companyRole": "OWNER",
  "businessFreeFormDescription": "We create cutting-edge software for businesses.",
  "firstLevelCategory": "CONSULTING_IT_BUSINESS_SERVICES",
  "secondLevelCategory": "IT_DEVELOPMENT",
  "operationalAddresses": [
    {
      "id": 36086782,
      "addressFirstLine": "24 Willow Creek Lane",
      "city": "Bristol",
      "countryIso2Code": "GB",
      "countryIso3Code": "gbr",
      "postCode": "BS1 6AE"
    }
  ],
  "fullName": "Innovate Solutions Ltd"
}