v5

latestOpenAPI 3.1.02026-07-262421791.5 MB

profile

Update business representative

Update or transfer the Business Representative for the specified Business Profile.

Set updateContext to UPDATE_DETAILS to update the existing Business Representative's details, or TRANSFER_OF_AUTHORISATION to transfer authority of the Business Profile to a new Business Representative.

{% admonition type="info" %} If the Business Representative has been verified then there are restrictions on what information is allowed to change. {% /admonition %}

{% admonition type="info" %} If this Business Representative is shared across multiple Business Profiles, then changes will be reflected for all of the Business Profiles. {% /admonition %}

When using TRANSFER_OF_AUTHORISATION, this will overwrite the existing Business Representative. The new Business Representative will need to be verified for KYC purposes.

put/v3/profiles/{profileId}/business-profile/business-representative

Path parameters

profileIdinteger required

Business profile ID.

Headers

X-External-Correlation-Idstring uuid

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Request body

updateContext'UPDATE_DETAILS' | 'TRANSFER_OF_AUTHORISATION'

Context of the update.

firstNamestring

First name of the person representing the business (including middle names).

lastNamestring

Last name of the person representing the business.

preferredNamestring

Preferred first name, if different to the legal first name.

dateOfBirthstring

Date of birth.

actorEmailstring

Email of the actor.

Example request

{
  "updateContext": "UPDATE_DETAILS",
  "firstName": "Oliver",
  "lastName": "Wilson",
  "preferredName": "Olivia",
  "address": {
    "addressFirstLine": "50 Sunflower Ave",
    "city": "Phoenix",
    "countryIso3Code": "usa",
    "postCode": "10025",
    "stateCode": "AZ"
  },
  "contactDetails": {
    "email": "o.wilson@example.com",
    "phoneNumber": "+3725064992"
  },
  "dateOfBirth": "1977-07-01",
  "actorEmail": "biz-acct@abcl.com"
}

Response

Business representative updated successfully.