Change Gift Information


This documentation is for translated APIs and intended only for some implementations who have upgraded from a previous version of Order Management. Verify whether your implementation uses translated APIs before making this call, as you will experience errors if your tenant is not configured to use these. If your implementation is not configured to do so, then refer to the standard API documentation instead.

This API allows the gift information of an order to be edited. The recipient and message of the gift can be specified, and even the recipient’s email and phone number can be provided if desired. 

Note that the request body and parameter schemas outlined in this guide are the exact same as in the previous version of OMS, as the Unified Commerce platform supports backwards compatibility for this API. The only change to this request is the format of the base endpoint, as shown in the below table. Remember to provide the x-vol-tenant key for authentication in the headers.

Production URLhttps://{tenantId}
Sandbox URLhttps://{tenantId}
Supported FormatsJSON


The example case will apply the following gift properties to an order:

  • Order ID 012345
  • Set as a gift to John Doe
  • Includes placeholder gift message

Required Parameters

The required information for this request includes:

orderIDintegerA unique identifier for the order. The minimum value is “1”.
recipientstringThe name of the gift recipient. The maximum length is 100.

Optional Parameters

The additional properties that can be added to further define gift information are:

messagestringA message to the gift recipient. The maximum length is 16384.
emailstringThe email address of the recipient.
phonestringThe phone number. The minimum length is 1 and the maximum length is 20.

The Full Request

This is the entire request that will edit the order’s gift information.

  "orderID": 012345,
  "recipient": "John Doe",
  "message": "this is the gift message"

The returned response follows the same structure as the Get Order API, providing information about the order that was edited.