Update a Recipient

Update the profile information in a Recipient Account (name, phone number, nationality, and additional information).

Endpoint

PUT /v1/recipients/{recipientId}

Authorization Header

Authorization: Bearer <access_token>

Path Parameters

recipientId REQUIRED

string (UUID)

Recipient Account ID.

Request Body

firstName

string, max length: 40, min length: 1

Recipient’s first name.

middleName

string, max length: 40, min length: 1

Recipient’s middle name.

lastName

string, max length: 40, min length: 1

Recipient’s last name.

secondLastName

string, max length: 40, min length: 1

Recipient’s second last name.

phoneNumber

string, max length: 40

Recipient’s phone number. Example: 555-555-5555

nationality

string, max length: 3

Recipient’s nationality. Must be an ISO 3166-1 uppercase alpha 3-character country code. For example, the United States is USA.

additionalInformation

string, max length: 500, min length: 0

Additional information about the recipient.

Returns

Returns the Recipient Account details. For details, see the Recipient object.

SAMPLE REQUEST

				
					{
  "phoneNumber": "9055621258",
}

SAMPLE RESPONSE

				
					{
  "id": "6a017f06-83a3-44b7-be6f-5e5cae4a9ed7",
  "businessAccountId": "8th32z87-3845-9810-v7gu-1f827g98swk3",
  "businessRefId": "RECIP001",
  "firstName": "John",
  "middleName": "",
  "lastName": "Smith",
  "secondLastName": "",
  "email": "jsmith@xyz.com",
  "phoneNumber": "9055621258",
  "nationality": "Canadian",
  "dateOfBirth": "1970-07-08",
  "additionalInformation": "",
  "recipientType": "INDIVIDUAL",
  "businessName": "",
  "state": "ACTIVE",
  "createdBy": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "type": "employee"
  },
  "createdAt": "2021-09-20T22:09:31.947Z",
  "updatedBy": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "type": "employee"
  },
  "updatedAt": "2021-10-20T22:09:31.947Z",
  "requestorId": "9kj43t32-2956-2886-x7dy-6r821w39kra3"
}