BusinessProfile
A business profile: create or update one.
Operations
Every route this entity exposes. Each route links to its own reference on this page.
| Method | Route | SDK operation | Returns |
|---|---|---|---|
POST |
/profiles/business-profile |
create |
Created business profile |
PUT |
/profiles/{profileId}/business-profile |
update |
Updated business profile |
Examples
One example per SDK, generated from the API model. The argument names are the parameters and fields of this entity, and the values are placeholders. The examples are not compiled or executed.
Golang
Construct client as shown in the Golang setup, then call the operations:
created, err := client.BusinessProfile(nil).Create(map[string]any{"contactDetails": map[string]any{}}, nil)
if err != nil {
panic(err)
}
fmt.Println(created)
updated, err := client.BusinessProfile(nil).Update(map[string]any{"profile_id": 1, "abn": "example"}, nil)
if err != nil {
panic(err)
}
fmt.Println(updated)
Lua
Construct client as shown in the Lua setup, then call the operations:
local created, err = client:BusinessProfile():create({ contactDetails = {} })
local updated, err = client:BusinessProfile():update({ profile_id = 1, abn = "example" })
PHP
Construct client as shown in the PHP setup, then call the operations:
$created = $client->BusinessProfile()->create(["contactDetails" => []]);
$updated = $client->BusinessProfile()->update(["profile_id" => 1, "abn" => "example"]);
Python
Construct client as shown in the Python setup, then call the operations:
created = client.BusinessProfile().create({ "contactDetails": {} })
updated = client.BusinessProfile().update({"profile_id": 1, "abn": "example"})
Ruby
Construct client as shown in the Ruby setup, then call the operations:
created = client.BusinessProfile.create({ "contactDetails" => {} })
updated = client.BusinessProfile.update({ "profile_id" => 1, "abn" => "example" })
TypeScript
Construct client as shown in the TypeScript setup, then call the operations:
const created = await client.BusinessProfile().create({ contactDetails: {} })
const updated = await client.BusinessProfile().update({ profile_id: 1, abn: "example" })
Fields
| Field | Type | Required | Description |
|---|---|---|---|
abn |
one,string,null |
No | Australian Business Number (only for Australian businesses). |
acn |
one,string,null |
No | Australian Company Number (only for Australian businesses). |
actorEmail |
string |
No | Email of the actor. |
address |
object |
No | Main registered address of the business. |
arbn |
one,string,null |
No | Australian Registered Body Number (only for Australian businesses). |
businessFreeFormDescription |
string |
No | Free-form description of the business activities. |
businessName |
string |
No | Registered business name. |
businessNameInKatakana |
one,string,null |
No | Business name in Katakana (only for Japanese businesses). |
businessRepresentative |
object |
No | Business representative details. |
companyRole |
string |
No | Role of the person managing the business profile. |
companyType |
string |
No | Type of company. |
contactDetails |
object |
No | Contact information for the business. |
createdAt |
string |
No | Timestamp when the profile was created (ISO 8601 format). |
currentState |
string |
No | Current status of this profile. |
descriptionOfBusiness |
string |
No | Deprecated. |
email |
string |
No | Primary email address for the business. |
externalCustomerId |
string |
No | An external reference identifier mapping the customer of this profile to your system. |
firstLevelCategory |
string |
No | Deprecated. |
fullName |
string |
No | Full legal name of the business. |
id |
integer |
No | Unique identifier for the profile. |
industryCategories |
array |
No | One or more industry categories classifying the business. |
operationalAddresses |
array |
No | An array of operational addresses for the business. |
publicId |
string |
No | Publicly accessible identifier for the profile. |
registrationNumber |
string |
No | Business registration number. |
secondLevelCategory |
string |
No | Deprecated. |
type |
string |
Yes | Type of profile. |
updatedAt |
string |
No | Timestamp when the profile was last updated (ISO 8601 format). |
userId |
integer |
No | The ID of the user associated with this profile. |
webpage |
string |
No | Business website URL. |
create
POST /profiles/business-profile
Operation ID: profileBusinessCreateV3.
Authentication: bearer token (UserToken).
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
X-idempotence-uuid |
header |
string (uuid) |
No | Unique idempotency key for the request. |
X-External-Correlation-Id |
header |
string (uuid) |
No | Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more. |
Request body
application/json
| Property | Type | Required | Description |
|---|---|---|---|
abn |
string,null |
No | Australian Business Number (only for Australian businesses). |
acn |
string,null |
No | Australian Company Number (only for Australian businesses). |
actorEmail |
string |
No | Email of the actor. |
address |
object |
No | |
address.addressFirstLine |
string |
No | First line of address. |
address.city |
string |
No | City. |
address.countryIso2Code |
string |
No | 2 letter country code. |
address.countryIso3Code |
string |
No | 3 letter country code. Must be lowercase. |
address.postCode |
string |
No | Postal code. |
address.stateCode |
string |
No | State code. |
arbn |
string,null |
No | Australian Registered Body Number (only for Australian businesses). |
businessFreeFormDescription |
string |
No | 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. |
businessName |
string |
No | Business name. |
businessNameInKatakana |
string,null |
No | Business name in Katakana (only for Japanese businesses). |
businessRepresentative |
object |
No | Business representative details. Provide either the full representative details or just the businessRepresentativeId to link an existing representative. |
businessRepresentative.address |
object |
No | |
businessRepresentative.address.addressFirstLine |
string |
No | First line of address. Required unless Business Representative ID is provided. |
businessRepresentative.address.city |
string |
No | City. Required unless Business Representative ID is provided. |
businessRepresentative.address.countryIso3Code |
string |
No | 3 letter country code (lower case). Required unless Business Representative ID is provided. |
businessRepresentative.address.postCode |
string |
No | Postal code. |
businessRepresentative.address.stateCode |
string |
No | State code (max 5 chars). Required for US, CA, BR and AU addresses unless Business Representative ID is provided. |
businessRepresentative.businessRepresentativeId |
integer |
No | 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.contactDetails |
object |
No | |
businessRepresentative.contactDetails.email |
string |
No | Contact email address. Required unless Business Representative ID is provided. |
businessRepresentative.contactDetails.phoneNumber |
string |
No | Contact phone number in international phone number format. Required unless Business Representative ID is provided. |
businessRepresentative.dateOfBirth |
string |
No | Date of birth. Required unless Business Representative ID is provided. |
businessRepresentative.firstName |
string |
No | First name of the person representing the business (including middle names). Required unless Business Representative ID is provided. |
businessRepresentative.lastName |
string |
No | Last name of the person representing the business. Required unless Business Representative ID is provided. |
businessRepresentative.localizedInformation |
array of object |
No | Optional localized information for the business representative. For Kana names, provide both firstName and lastName entries with localeScriptCode set to Kana. Each combination of key and localeScriptCode must be unique. |
businessRepresentative.localizedInformation[].key |
string |
Yes | Name of the field being localized. |
businessRepresentative.localizedInformation[].localeScriptCode |
string |
Yes | Script code for the localized value. |
businessRepresentative.localizedInformation[].value |
string |
Yes | Localized value of the field. |
businessRepresentative.preferredName |
string |
No | Preferred first name, if different to the legal first name. |
companyRole |
enum: OWNER, DIRECTOR, OTHER |
No | Role of person. |
companyType |
enum: LIMITED, PARTNERSHIP, SOLE_TRADER, LIMITED_BY_GUARANTEE, LIMITED_LIABILITY_COMPANY, FOR_PROFIT_CORPORATION, ... |
No | Company legal form. |
contactDetails |
object |
No | Optional contact details for the business, separate from the representative's contact details. |
contactDetails.email |
string (email) |
Yes | Contact email address for the business. |
contactDetails.phoneNumber |
string |
Yes | Contact phone number for the business. |
externalCustomerId |
string |
No | An external reference identifier mapping the customer of this profile to your system. |
firstLevelCategory |
string |
No | Legacy primary business category. Use industryCategories instead. Cannot be combined with industryCategories. |
industryCategories |
array of string |
No | One or more industry categories classifying the business. See Business Categories for the full list of valid values. |
operationalAddresses |
array of object |
No | List of operational addresses. |
operationalAddresses[].addressFirstLine |
string |
No | |
operationalAddresses[].city |
string |
No | |
operationalAddresses[].countryIso2Code |
string |
No | |
operationalAddresses[].countryIso3Code |
string |
No | |
operationalAddresses[].postCode |
string |
No | |
operationalAddresses[].stateCode |
string |
No | |
registrationNumber |
string |
No | Business registration number. |
secondLevelCategory |
string |
No | Legacy secondary business category. Use industryCategories instead. Cannot be combined with industryCategories. |
webpage |
string |
No | 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. |
Responses
200: Created business profile
application/json
| Property | Type | Required | Description |
|---|---|---|---|
address |
object |
No | Main registered address of the business. |
address.addressFirstLine |
string |
No | First line of the address. |
address.city |
string |
No | City of the address. |
address.countryIso2Code |
string |
No | Two-letter ISO country code. |
address.countryIso3Code |
string |
No | Three-letter ISO country code. |
address.id |
integer (int64) |
No | ID of the address. |
address.postCode |
string |
No | Postal code of the address. |
address.stateCode |
string,null |
No | State code of the address (can be null for some countries). |
businessFreeFormDescription |
string |
No | Free-form description of the business activities. |
businessName |
string |
No | Registered business name. |
companyRole |
enum: OWNER, DIRECTOR, OTHER |
No | Role of the person managing the business profile. |
companyType |
string |
No | Type of company. |
contactDetails |
object |
No | Contact information for the business. |
contactDetails.email |
string |
No | Contact email address. |
contactDetails.phoneNumber |
string |
No | Contact phone number. |
createdAt |
string (date-time) |
No | Timestamp when the profile was created (ISO 8601 format). |
currentState |
enum: HIDDEN, VISIBLE, DEACTIVATED |
No | Current status of this profile. |
descriptionOfBusiness |
string |
No | Deprecated. New integrations should use industryCategories. See Migrating to industry categories. |
email |
string |
No | Primary email address for the business. |
firstLevelCategory |
string |
No | 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. |
fullName |
string |
No | Full legal name of the business. |
id |
integer (int64) |
No | Unique identifier for the profile. |
industryCategories |
array of string |
No | 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. |
operationalAddresses |
array of object |
No | An array of operational addresses for the business. |
operationalAddresses[].addressFirstLine |
string |
No | First line of the address. |
operationalAddresses[].city |
string |
No | City of the address. |
operationalAddresses[].countryIso2Code |
string |
No | Two-letter ISO country code. |
operationalAddresses[].countryIso3Code |
string |
No | Three-letter ISO country code. |
operationalAddresses[].id |
integer (int64) |
No | ID of the address. |
operationalAddresses[].postCode |
string |
No | Postal code of the address. |
operationalAddresses[].stateCode |
string,null |
No | State code of the address (can be null for some countries). |
publicId |
string |
No | Publicly accessible identifier for the profile. |
registrationNumber |
string |
No | Business registration number. |
secondLevelCategory |
string |
No | 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. |
type |
enum: BUSINESS |
Yes | Type of profile. |
updatedAt |
string (date-time) |
No | Timestamp when the profile was last updated (ISO 8601 format). |
userId |
integer (int64) |
No | The ID of the user associated with this profile. |
webpage |
string |
No | Business website URL. |
429: Rate limit exceeded. Retry after the number of seconds specified in the Retry-After header
application/json
The response is object.
update
PUT /profiles/{profileId}/business-profile
Operation ID: profileBusinessUpdate.
Authentication: bearer token (UserToken) or bearer token (PersonalToken).
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
profileId |
path |
integer (int64) |
Yes | Business profile ID. |
X-External-Correlation-Id |
header |
string (uuid) |
No | Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more. |
Request body
application/json
| Property | Type | Required | Description |
|---|---|---|---|
abn |
string,null |
No | Australian Business Number (only for Australian businesses). |
acn |
string,null |
No | Australian Company Number (only for Australian businesses). |
address |
object |
No | |
address.addressFirstLine |
string |
No | First line of address. |
address.city |
string |
No | City. |
address.countryIso2Code |
string |
No | 2 letter country code. |
address.countryIso3Code |
string |
No | 3 letter country code. Must be lowercase. |
address.postCode |
string |
No | Postal code. |
address.stateCode |
string |
No | State code. |
arbn |
string,null |
No | Australian Registered Body Number (only for Australian businesses). |
businessFreeFormDescription |
string |
No | Business free form description. |
businessName |
string |
No | Business name. |
businessNameInKatakana |
string,null |
No | Business name in Katakana (only for Japanese businesses). |
companyRole |
enum: OWNER, DIRECTOR, OTHER |
No | Role of person. |
companyType |
enum: LIMITED, PARTNERSHIP, SOLE_TRADER, LIMITED_BY_GUARANTEE, LIMITED_LIABILITY_COMPANY, FOR_PROFIT_CORPORATION, ... |
No | Company legal form. |
contactDetails |
object |
No | Optional contact details for the business, separate from the representative's contact details. |
contactDetails.email |
string (email) |
Yes | Contact email address for the business. |
contactDetails.phoneNumber |
string |
Yes | Contact phone number for the business. |
externalCustomerId |
string |
No | An external reference identifier mapping the customer of this profile to your system. |
firstLevelCategory |
string |
No | Legacy primary business category. Use industryCategories instead. Cannot be combined with industryCategories. |
id |
integer (int64) |
No | Business profile ID. This must match the business profile ID supplied in the URL. |
industryCategories |
array of string |
No | One or more industry categories classifying the business. See Business Categories for the full list of valid values. |
operationalAddresses |
array of object |
No | List of operational addresses. |
operationalAddresses[].addressFirstLine |
string |
No | |
operationalAddresses[].city |
string |
No | |
operationalAddresses[].countryIso2Code |
string |
No | |
operationalAddresses[].countryIso3Code |
string |
No | |
operationalAddresses[].postCode |
string |
No | |
operationalAddresses[].stateCode |
string |
No | |
registrationNumber |
string |
No | Business registration number. |
secondLevelCategory |
string |
No | Legacy secondary business category. Use industryCategories instead. Cannot be combined with industryCategories. |
webpage |
string |
No | 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. |
Responses
200: Updated business profile
application/json
| Property | Type | Required | Description |
|---|---|---|---|
address |
object |
No | Main registered address of the business. |
address.addressFirstLine |
string |
No | First line of the address. |
address.city |
string |
No | City of the address. |
address.countryIso2Code |
string |
No | Two-letter ISO country code. |
address.countryIso3Code |
string |
No | Three-letter ISO country code. |
address.id |
integer (int64) |
No | ID of the address. |
address.postCode |
string |
No | Postal code of the address. |
address.stateCode |
string,null |
No | State code of the address (can be null for some countries). |
businessFreeFormDescription |
string |
No | Free-form description of the business activities. |
businessName |
string |
No | Registered business name. |
companyRole |
enum: OWNER, DIRECTOR, OTHER |
No | Role of the person managing the business profile. |
companyType |
string |
No | Type of company. |
contactDetails |
object |
No | Contact information for the business. |
contactDetails.email |
string |
No | Contact email address. |
contactDetails.phoneNumber |
string |
No | Contact phone number. |
createdAt |
string (date-time) |
No | Timestamp when the profile was created (ISO 8601 format). |
currentState |
enum: HIDDEN, VISIBLE, DEACTIVATED |
No | Current status of this profile. |
descriptionOfBusiness |
string |
No | Deprecated. New integrations should use industryCategories. See Migrating to industry categories. |
email |
string |
No | Primary email address for the business. |
firstLevelCategory |
string |
No | 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. |
fullName |
string |
No | Full legal name of the business. |
id |
integer (int64) |
No | Unique identifier for the profile. |
industryCategories |
array of string |
No | 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. |
operationalAddresses |
array of object |
No | An array of operational addresses for the business. |
operationalAddresses[].addressFirstLine |
string |
No | First line of the address. |
operationalAddresses[].city |
string |
No | City of the address. |
operationalAddresses[].countryIso2Code |
string |
No | Two-letter ISO country code. |
operationalAddresses[].countryIso3Code |
string |
No | Three-letter ISO country code. |
operationalAddresses[].id |
integer (int64) |
No | ID of the address. |
operationalAddresses[].postCode |
string |
No | Postal code of the address. |
operationalAddresses[].stateCode |
string,null |
No | State code of the address (can be null for some countries). |
publicId |
string |
No | Publicly accessible identifier for the profile. |
registrationNumber |
string |
No | Business registration number. |
secondLevelCategory |
string |
No | 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. |
type |
enum: BUSINESS |
Yes | Type of profile. |
updatedAt |
string (date-time) |
No | Timestamp when the profile was last updated (ISO 8601 format). |
userId |
integer (int64) |
No | The ID of the user associated with this profile. |
webpage |
string |
No | Business website URL. |
429: Rate limit exceeded. Retry after the number of seconds specified in the Retry-After header
application/json
The response is object.