Create a business profile (V2)

Create a business profile (V2)
deprecated

Request

This endpoint is deprecated. New integrations should use the V4 endpoint. See Migrating to industry categories.

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.

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.

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

Security

UserToken or PersonalToken

X-idempotence-uuidstring, (uuid)

Unique idempotency key for the request.

X-External-Correlation-Idstring, (uuid), <= 36 characters

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

Example:f47ac10b-58cc-4372-a567-0e02b2c3d479

Bodyapplication/json

businessNamestring

Business name.

Example:"ABC Logistics Ltd"

businessNameInKatakanastring or null

Business name in Katakana (only for Japanese businesses).

Example:null

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.

Example:"Biz free form desc"

registrationNumberstring

Business registration number.

Example:"12144939"

acnstring or null

Australian Company Number (only for Australian businesses).

Example:null

abnstring or null

Australian Business Number (only for Australian businesses).

Example:null

arbnstring or null

Australian Registered Body Number (only for Australian businesses).

Example:null

companyTypestring

Company legal form.

Enum:"LIMITED""PARTNERSHIP""SOLE_TRADER""LIMITED_BY_GUARANTEE""LIMITED_LIABILITY_COMPANY""FOR_PROFIT_CORPORATION""NON_PROFIT_CORPORATION""LIMITED_PARTNERSHIP""LIMITED_LIABILITY_PARTNERSHIP""GENERAL_PARTNERSHIP"

Example:"LIMITED"

companyRolestring

Role of person.

Enum:"OWNER""DIRECTOR""OTHER"

Example:"OWNER"

addressobject

externalCustomerIdstring

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

Example:"67890-biz-acct"

actorEmailstring

Email of the actor.

Example:"biz-acct@abcl.com"

operationalAddressesArray of objects

List of operational addresses.

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:"https://abc-logistics.com"

firstLevelCategorystringdeprecated

Legacy primary business category. New integrations should use industryCategories on the V4 endpoint instead. See Migrating to industry categories.

Example:"CONSULTING_IT_BUSINESS_SERVICES"

secondLevelCategorystringdeprecated

Legacy secondary business category. New integrations should use industryCategories on the V4 endpoint instead. See Migrating to industry categories.

Example:"DESIGN"

curl -i -X POST \
  https://api.wise.com/v2/profiles/business-profile \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-External-Correlation-Id: f47ac10b-58cc-4372-a567-0e02b2c3d479' \
  -H 'X-idempotence-uuid: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -d '{
    "businessName": "ABC Logistics Ltd",
    "businessNameInKatakana": null,
    "businessFreeFormDescription": "Biz free form desc",
    "registrationNumber": "12144939",
    "acn": null,
    "abn": null,
    "arbn": null,
    "companyType": "LIMITED",
    "companyRole": "OWNER",
    "address": {
      "addressFirstLine": "1 A road",
      "city": "London",
      "countryIso2Code": "gb",
      "countryIso3Code": "gbr",
      "postCode": "11111",
      "stateCode": "string"
    },
    "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",
        "stateCode": "string"
      }
    ],
    "webpage": "https://abc-logistics.com"
  }'

Responses

Created business profile.

Headers

X-External-Correlation-Idstring, (uuid), <= 36 characters

Echoed back when X-External-Correlation-Id was included in the request. Learn more.

Example:"f47ac10b-58cc-4372-a567-0e02b2c3d479"

x-trace-idstring

Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.

Example:"fba501b6d453b96789f52338f019341f"

Bodyapplication/json

typestringrequired

Type of profile.

Value:"BUSINESS"

Example:"BUSINESS"

idinteger, (int64)

Unique identifier for the profile.

Example:14599371

publicIdstring

Publicly accessible identifier for the profile.

Example:"f0e9d8c7-b6a5-4321-fedc-ba9876543210"

userIdinteger, (int64)

The ID of the user associated with this profile.

Example:9889627

addressobject

Main registered address of the business.

emailstring

Primary email address for the business.

Example:"info@innovate-solutions.co.uk"

createdAtstring, (date-time)

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

Example:"2024-03-10T09:00:00"

updatedAtstring, (date-time)

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

Example:"2025-06-18T14:22:00"

currentStatestring

Current status of this profile.

Enum:"HIDDEN""VISIBLE""DEACTIVATED"

Example:"VISIBLE"

contactDetailsobject

Contact information for the business.

businessNamestring

Registered business name.

Example:"Innovate Solutions Ltd"

registrationNumberstring

Business registration number.

Example:"SC1234567890ABCD"

descriptionOfBusinessstring

Brief description of the business.

Example:"SOFTWARE_DEVELOPMENT"

webpagestring

Business website URL.

Example:"https://www.innovate-solutions.co.uk"

companyTypestring

Type of company.

Example:"LIMITED_COMPANY"

companyRolestring

Role of the person managing the business profile.

Enum:"OWNER""DIRECTOR""OTHER"

Example:"OWNER"

businessFreeFormDescriptionstring

Free-form description of the business activities.

Example:"We create cutting-edge software for businesses."

firstLevelCategorystring

Primary business category.

Example:"CONSULTING_IT_BUSINESS_SERVICES"

secondLevelCategorystring

Secondary business category.

Example:"IT_DEVELOPMENT"

operationalAddressesArray of objects

An array of operational addresses for the business.

fullNamestring

Full legal name of the business.

Example:"Innovate Solutions Ltd"

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",
    "stateCode": null
  },
  "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",
      "stateCode": null
    }
  ],
  "fullName": "Innovate Solutions Ltd"
}