# Create a business profile (V3, beta)

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

{% admonition type="warning" %}
This endpoint will soon be deprecated, please use the /v2 endpoints instead.
{% /admonition %}

{% 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.

Endpoint: POST /v3/profiles/business-profile
Security: UserToken

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

  - `businessRepresentative` (object)
    Business representative details. Provide either the full representative details or just the businessRepresentativeId to link an existing representative.

  - `businessRepresentative.businessRepresentativeId` (integer)
    ID of a Business Representative. This can be obtained from a previous call to create a business profile, in which case the same Business Representative is linked to the current business effectively sharing it across multiple businesses. When the Business Representative ID is provided, it is the only field required and none of the other fields should be provided.

  - `businessRepresentative.firstName` (string)
    First name of the person representing the business (including middle names). Required unless Business Representative ID is provided.
    Example: "Oliver"

  - `businessRepresentative.lastName` (string)
    Last name of the person representing the business. Required unless Business Representative ID is provided.
    Example: "Wilson"

  - `businessRepresentative.preferredName` (string)
    Preferred first name, if different to the legal first name.
    Example: "Olivia"

  - `businessRepresentative.address` (object)

  - `businessRepresentative.address.addressFirstLine` (string)
    First line of address. Required unless Business Representative ID is provided.
    Example: "50 Sunflower Ave"

  - `businessRepresentative.address.city` (string)
    City. Required unless Business Representative ID is provided.
    Example: "Phoenix"

  - `businessRepresentative.address.countryIso3Code` (string)
    3 Letter country code (lower case). Required unless Business Representative ID is provided.
    Example: "usa"

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

  - `businessRepresentative.address.stateCode` (string)
    State code (max 5 chars). Required for US, CA, BR and AU addresses unless Business Representative ID is provided.
    Example: "AZ"

  - `businessRepresentative.contactDetails` (object)

  - `businessRepresentative.contactDetails.email` (string)
    Contact email address. Required unless Business Representative ID is provided.
    Example: "o.wilson@example.com"

  - `businessRepresentative.contactDetails.phoneNumber` (string)
    Contact phone number in international phone number format. Required unless Business Representative ID is provided.
    Example: "+3725064992"

  - `businessRepresentative.dateOfBirth` (string)
    Date of birth. Required unless Business Representative ID is provided.
    Example: "1977-07-01"


## Response 200 fields