🔒
Requires write_gift_cards access scope. More access scope

The Update Gift Card API updates the details of a specific gift card using its unique ID.

This API is especially useful for:

Updating the expiration date of a gift card.
Modifying notes attached to a gift card.
Changing the template used for rendering a gift card.

Request Parameters

Public Request Parameters

📘
Public Request Parameters

Path Parameters

Field	Type	Required	Example	Description
`id`	`string`	Yes	`377026890382183978`	Gift card's unique ID.

Response Explanation

Public Response Parameters

📘
Public Response Parameters

Successful Response

Parameter	Type	Example	Description
`code`	string	`"200"`	The status code of the response
`message`	string	`"success"`	The message describing the response status
`data.gift_card.id`	string	`"gc_123456"`	Unique identifier for the gift card
`data.gift_card.last_characters`	string	`"456"`	Last characters of the gift card code
`data.gift_card.balance`	string	`"100.00"`	Current balance of the gift card
`data.gift_card.initial_value`	string	`"100.00"`	The initial value of the gift card
`data.gift_card.note`	string	`"Birthday gift for John"`	Note attached to the gift card
`data.gift_card.expires_on`	string	`"2025-12-31T23:59:59Z"`	Expiration date of the gift card in ISO-8601 format
`data.gift_card.disabled_at`	string	`null`	Timestamp when the gift card was disabled (null if active)
`data.gift_card.enabled`	boolean	`true`	Whether the gift card is currently enabled
`data.gift_card.created_at`	string	`"2025-06-01T10:00:00Z"`	Timestamp of when the gift card was created
`data.gift_card.updated_at`	string	`"2025-06-01T10:00:00Z"`	Timestamp of when the gift card was last updated
`data.gift_card.status`	string	`"enabled"`	Status of the gift card (enable or disable)
`data.gift_card.currency`	string	`"USD"`	Currency in which the gift card is denominated
`data.gift_card.line_item_id`	string	`"li_123"`	ID of the line item associated with the gift card
`data.gift_card.order_id`	string	`"order_456"`	ID of the order associated with the gift card
`data.gift_card.user_id`	string	`"user_789"`	User ID of the creator or owner of the gift card
`data.gift_card.template_suffix`	string	`"birthday"`	Suffix of the template used to render the gift card online
`data.gift_card.customer_id`	string	`"cust_12345"`	Customer ID associated with the gift card
`data.gift_card.code`	string	`"GIFT123456"`	The gift card code, consisting of alphanumeric characters

Error Response

Field	Type	Example	Description
`code`	string	`InvalidParameter`	Error http message
`message`	string	``	Error message

200OK

400InvalidParameter

500ServerError