Create a business profile (V3)

Request

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

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.

See Business Categories for the list of valid industryCategories values. Send either industryCategories or the deprecated firstLevelCategory/secondLevelCategory pair, supplying both in one request returns a 400. If you currently send the legacy fields, see Migrating to industry categories.

Security

UserToken

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

contactDetailsobject

Optional contact details for the business, separate from the representative's contact details.

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"

industryCategoriesArray of strings, non-empty

One or more industry categories classifying the business. See Business Categories for the full list of valid values.

Example:

[
  "SOFTWARE_DEVELOPMENT_PUBLISHING",
  "IT_CONSULTANCY_TECHNICAL_SUPPORT_SERVICES"
]

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"

businessRepresentativeobject

Business representative details. Provide either the full representative details or just the businessRepresentativeId to link an existing representative.

firstLevelCategorystringdeprecated

Legacy primary business category. Use industryCategories instead. Cannot be combined with industryCategories.

Example:"CONSULTING_IT_BUSINESS_SERVICES"

secondLevelCategorystringdeprecated

Legacy secondary business category. Use industryCategories instead. Cannot be combined with industryCategories.

Example:"DESIGN"

curl -i -X POST \
  https://api.wise.com/v3/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"
    },
    "contactDetails": {
      "email": "contact@innovate-solutions.co.uk",
      "phoneNumber": "+441617891234"
    },
    "externalCustomerId": "67890-biz-acct",
    "actorEmail": "biz-acct@abcl.com",
    "industryCategories": [
      "SOFTWARE_DEVELOPMENT_PUBLISHING",
      "IT_CONSULTANCY_TECHNICAL_SUPPORT_SERVICES"
    ],
    "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"
      },
      "dateOfBirth": "1977-07-01",
      "contactDetails": {
        "email": "o.wilson@example.com",
        "phoneNumber": "+3725064992"
      }
    }
  }'

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"

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

industryCategoriesArray of strings

One or more industry categories classifying the business. See Business Categories for the full list of valid values.

Populated only when the profile was classified with industryCategories, otherwise null. Create and update responses return the format you did not send as null, only retrieve a profile derives both formats.

Example:

[
  "SOFTWARE_DEVELOPMENT_PUBLISHING",
  "IT_CONSULTANCY_TECHNICAL_SUPPORT_SERVICES"
]

operationalAddressesArray of objects

An array of operational addresses for the business.

fullNamestring

Full legal name of the business.

Example:"Innovate Solutions Ltd"

descriptionOfBusinessstringdeprecated

Deprecated. New integrations should use industryCategories. See Migrating to industry categories.

Example:"SOFTWARE_DEVELOPMENT"

firstLevelCategorystringdeprecated

Deprecated. New integrations should use industryCategories. See Migrating to industry categories.

Example:"CONSULTING_IT_BUSINESS_SERVICES"

secondLevelCategorystringdeprecated

Deprecated. New integrations should use industryCategories. See Migrating to industry categories.

Populated only when the profile was classified with the legacy fields, otherwise null. Create and update responses return the format you did not send as null, only retrieve a profile derives both formats, where it may return UNMAPPED if the industryCategories combination has no legacy equivalent.

Example:"IT_DEVELOPMENT"

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",
  "industryCategories": [
    "SOFTWARE_DEVELOPMENT_PUBLISHING",
    "IT_CONSULTANCY_TECHNICAL_SUPPORT_SERVICES"
  ],
  "operationalAddresses": [
    {
      "id": 36086782,
      "addressFirstLine": "24 Willow Creek Lane",
      "city": "Bristol",
      "countryIso2Code": "GB",
      "countryIso3Code": "gbr",
      "postCode": "BS1 6AE",
      "stateCode": null
    }
  ],
  "fullName": "Innovate Solutions Ltd"
}