Design  /  Recipient Use Cases  /  Update a Recipient

Update a Recipient


In this use case, we’ll walk through updating the information in a Recipient Account.

A Recipient is a business or individual that you intend to conduct business with on the RocketKOR platform. A Recipient Account contains the recipient’s profile (name, contact information, and so on).

API Operation


Send a request to the following endpoint:

PUT /v1/recipients/{recipientId}

  • Include an Authorization header with your RocketKOR access token as a Bearer Token.
  • Use {recipientId} to specify the ID of the Recipient Account to be updated.
  • Include the fields you want to update in the request body. You can update the recipient’s name, phone number, nationality, and additional information. For more information, see the API Reference.

Sample Request

The following request would update the recipient’s phone number.

  "phoneNumber": "9055621258",

Sample Response

The updated Recipient Account details are returned. For details, see the Recipient object.

  "id": "6a017f06-83a3-44b7-be6f-5e5cae4a9ed7",
  "businessAccountId": "8th32z87-3845-9810-v7gu-1f827g98swk3",
  "businessRefId": "RECIP001",
  "firstName": "John",
  "middleName": "",
  "lastName": "Smith",
  "secondLastName": "",
  "email": "",
  "phoneNumber": "9055621258",
  "nationality": "Canadian",
  "dateOfBirth": "1970-07-08",
  "additionalInformation": "",
  "recipientType": "INDIVIDUAL",
  "businessName": "",
  "state": "ACTIVE",
  "createdAt": "2021-07-08T20:56:35.219Z",
  "updatedAt": "2021-07-08T20:56:35.219Z",
  "requestorId": "9kj43t32-2956-2886-x7dy-6r821w39kra3"