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

Endpoint: POST /v2/profiles/business-profile
Security: UserToken, PersonalToken

## Header parameters:

  - `X-idempotence-uuid` (string)
    Unique idempotency key for the request.

## Request fields (application/json):

  - `businessName` (string)
    Business name.
    Example: "ABC Logistics Ltd"

  - `businessNameInKatakana` (string,null)
    Business name in Katakana (only for Japanese businesses).

  - `businessFreeFormDescription` (string)
    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"

  - `registrationNumber` (string)
    Business registration number.
    Example: "12144939"

  - `acn` (string,null)
    Australian Company Number (only for Australian businesses).

  - `abn` (string,null)
    Australian Business Number (only for Australian businesses).

  - `arbn` (string,null)
    Australian Registered Body Number (only for Australian businesses).

  - `companyType` (string)
    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", "SOLE_PROPRIETORSHIP", "PRIVATE_LIMITED_COMPANY", "PUBLIC_LIMITED_COMPANY", "TRUST", "OTHER"

  - `companyRole` (string)
    Role of person.
    Enum: "OWNER", "DIRECTOR", "OTHER"

  - `address` (object)

  - `address.addressFirstLine` (string)
    First line of address.
    Example: "1 A road"

  - `address.city` (string)
    City.
    Example: "London"

  - `address.countryIso2Code` (string)
    2 letter country code.
    Example: "gb"

  - `address.countryIso3Code` (string)
    3 Letter country code. Must be lowercase.
    Example: "gbr"

  - `address.postCode` (string)
    Postal code.
    Example: "11111"

  - `address.stateCode` (string)
    State code.

  - `externalCustomerId` (string)
    An external reference identifier mapping the customer of this profile to your system.
    Example: "67890-biz-acct"

  - `actorEmail` (string)
    Email of the actor.
    Example: "biz-acct@abcl.com"

  - `firstLevelCategory` (string)
    [Category](/guides/developer/api-guides/business-categories) of the business.
    Example: "CONSULTING_IT_BUSINESS_SERVICES"

  - `secondLevelCategory` (string)
    [Secondary category](/guides/developer/api-guides/business-categories) of the business.
    Example: "DESIGN"

  - `operationalAddresses` (array)
    List of operational addresses.

  - `operationalAddresses.addressFirstLine` (string)
    Example: "1 A road"

  - `operationalAddresses.city` (string)
    Example: "London"

  - `operationalAddresses.countryIso2Code` (string)
    Example: "gb"

  - `operationalAddresses.countryIso3Code` (string)
    Example: "gbr"

  - `operationalAddresses.postCode` (string)
    Example: "11111"

  - `operationalAddresses.stateCode` (string)

  - `webpage` (string)
    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"

## Response 200 fields (application/json):

  - `type` (string, required)
    Type of profile.
    Enum: "BUSINESS"

  - `id` (integer)
    Unique identifier for the profile.
    Example: 14599371

  - `publicId` (string)
    Publicly accessible identifier for the profile.
    Example: "f0e9d8c7-b6a5-4321-fedc-ba9876543210"

  - `userId` (integer)
    The ID of the user associated with this profile.
    Example: 9889627

  - `address` (object)
    Main registered address of the business.

  - `address.id` (integer)
    ID of the address.
    Example: 36086782

  - `address.addressFirstLine` (string)
    First line of the address.
    Example: "24 Willow Creek Lane"

  - `address.city` (string)
    City of the address.
    Example: "Bristol"

  - `address.countryIso2Code` (string)
    Two-letter ISO country code.
    Example: "GB"

  - `address.countryIso3Code` (string)
    Three-letter ISO country code.
    Example: "gbr"

  - `address.postCode` (string)
    Postal code of the address.
    Example: "BS1 6AE"

  - `address.stateCode` (string,null)
    State code of the address (can be null for some countries).

  - `email` (string)
    Primary email address for the business.
    Example: "info@innovate-solutions.co.uk"

  - `createdAt` (string)
    Timestamp when the profile was created (ISO 8601 format).
    Example: "2024-03-10T09:00:00"

  - `updatedAt` (string)
    Timestamp when the profile was last updated (ISO 8601 format).
    Example: "2025-06-18T14:22:00"

  - `currentState` (string)
    Current status of this profile.
    Enum: "HIDDEN", "VISIBLE", "DEACTIVATED"

  - `contactDetails` (object)
    Contact information for the business.

  - `contactDetails.email` (string)
    Contact email address.
    Example: "contact@innovate-solutions.co.uk"

  - `contactDetails.phoneNumber` (string)
    Contact phone number.
    Example: "+441617891234"

  - `businessName` (string)
    Registered business name.
    Example: "Innovate Solutions Ltd"

  - `registrationNumber` (string)
    Business registration number.
    Example: "SC1234567890ABCD"

  - `descriptionOfBusiness` (string)
    Brief description of the business.
    Example: "SOFTWARE_DEVELOPMENT"

  - `webpage` (string)
    Business website URL.
    Example: "https://www.innovate-solutions.co.uk"

  - `companyType` (string)
    Type of company.
    Example: "LIMITED_COMPANY"

  - `companyRole` (string)
    Role of the person managing the business profile.
    Enum: "OWNER", "DIRECTOR", "OTHER"

  - `businessFreeFormDescription` (string)
    Free-form description of the business activities.
    Example: "We create cutting-edge software for businesses."

  - `firstLevelCategory` (string)
    Primary [business category](/guides/developer/api-guides/business-categories).
    Example: "CONSULTING_IT_BUSINESS_SERVICES"

  - `secondLevelCategory` (string)
    Secondary [business category](/guides/developer/api-guides/business-categories).
    Example: "IT_DEVELOPMENT"

  - `operationalAddresses` (array)
    An array of operational addresses for the business.

  - `operationalAddresses.id` (integer)
    ID of the address.
    Example: 36086782

  - `operationalAddresses.addressFirstLine` (string)
    First line of the address.
    Example: "24 Willow Creek Lane"

  - `operationalAddresses.city` (string)
    City of the address.
    Example: "Bristol"

  - `operationalAddresses.countryIso2Code` (string)
    Two-letter ISO country code.
    Example: "GB"

  - `operationalAddresses.countryIso3Code` (string)
    Three-letter ISO country code.
    Example: "gbr"

  - `operationalAddresses.postCode` (string)
    Postal code of the address.
    Example: "BS1 6AE"

  - `operationalAddresses.stateCode` (string,null)
    State code of the address (can be null for some countries).

  - `fullName` (string)
    Full legal name of the business.
    Example: "Innovate Solutions Ltd"