---
title: "Create a business profile"
method: POST
path: "/v2/profiles/business-profile"
tags: ["profile"]
---

# Create a business profile

`POST /v2/profiles/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](/guides/developer/api-guides/business-categories) for the list of valid `firstLevelCategory` and `secondLevelCategory` values.

## Headers

- `X-idempotence-uuid` string, uuid
- `X-External-Correlation-Id` string, uuid

## Request body

- object
  - `businessName` string — Business name.
  - `businessNameInKatakana` string, nullable — 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.
  - `registrationNumber` string — Business registration number.
  - `acn` string, nullable — Australian Company Number (only for Australian businesses).
  - `abn` string, nullable — Australian Business Number (only for Australian businesses).
  - `arbn` string, nullable — Australian Registered Body Number (only for Australian businesses).
  - `companyType` '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' — Company legal form.
  - `companyRole` 'OWNER' | 'DIRECTOR' | 'OTHER' — Role of person.
  - `address` object
    - `addressFirstLine` string — First line of address.
    - `city` string — City.
    - `countryIso2Code` string — 2 letter country code.
    - `countryIso3Code` string — 3 letter country code. Must be lowercase.
    - `postCode` string — Postal code.
    - `stateCode` string — State code.
  - `externalCustomerId` string — An external reference identifier mapping the customer of this profile to your system.
  - `actorEmail` string — Email of the actor.
  - `firstLevelCategory` string — [Category](/guides/developer/api-guides/business-categories) of the business.
  - `secondLevelCategory` string — [Secondary category](/guides/developer/api-guides/business-categories) of the business.
  - `operationalAddresses` object[] — List of operational addresses.
    - `addressFirstLine` string
    - `city` string
    - `countryIso2Code` string
    - `countryIso3Code` string
    - `postCode` string
    - `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.

## Response `200`

Created business profile.

- BusinessProfile
  - `type` 'BUSINESS', required — Type of profile.
  - `id` integer — Unique identifier for the profile.
  - `publicId` string — Publicly accessible identifier for the profile.
  - `userId` integer — The ID of the user associated with this profile.
  - `address` Address — Address associated with a profile.
    - `id` integer — ID of the address.
    - `addressFirstLine` string — First line of the address.
    - `city` string — City of the address.
    - `countryIso2Code` string — Two-letter ISO country code.
    - `countryIso3Code` string — Three-letter ISO country code.
    - `postCode` string — Postal code of the address.
    - `stateCode` string, nullable — State code of the address (can be null for some countries).
  - `email` string — Primary email address for the business.
  - `createdAt` string, date-time — Timestamp when the profile was created (ISO 8601 format).
  - `updatedAt` string, date-time — Timestamp when the profile was last updated (ISO 8601 format).
  - `currentState` 'HIDDEN' | 'VISIBLE' | 'DEACTIVATED' — Current status of this profile.
  - `contactDetails` object — Contact information for the business.
    - `email` string — Contact email address.
    - `phoneNumber` string — Contact phone number.
  - `businessName` string — Registered business name.
  - `registrationNumber` string — Business registration number.
  - `descriptionOfBusiness` string — Brief description of the business.
  - `webpage` string — Business website URL.
  - `companyType` string — Type of company.
  - `companyRole` 'OWNER' | 'DIRECTOR' | 'OTHER' — Role of the person managing the business profile.
  - `businessFreeFormDescription` string — Free-form description of the business activities.
  - `firstLevelCategory` string — Primary [business category](/guides/developer/api-guides/business-categories).
  - `secondLevelCategory` string — Secondary [business category](/guides/developer/api-guides/business-categories).
  - `operationalAddresses` Address[] — An array of operational addresses for the business.
    - `id` integer — ID of the address.
    - `addressFirstLine` string — First line of the address.
    - `city` string — City of the address.
    - `countryIso2Code` string — Two-letter ISO country code.
    - `countryIso3Code` string — Three-letter ISO country code.
    - `postCode` string — Postal code of the address.
    - `stateCode` string, nullable — State code of the address (can be null for some countries).
  - `fullName` string — Full legal name of the business.

## Other responses

- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/versions/4907a1d269ab/schema)