<- Gift Card Activities API

Gift Card Activities API

Create gift card activity

POST

 /v2/gift-cards/activities

Creates a gift card activity to manage the balance or state of a gift card.

For example, you create an ACTIVATE activity to activate a gift card with an initial balance before the gift card can be used.

Permissions:GIFTCARDS_WRITE

Guide

Manage the gift card balance or state

Try in API Explorer
Link to section

Request body

Example code

Link to section

idempotency_key

string

Required

A unique string that identifies the CreateGiftCardActivity request.

Min Length
1
Max Length
128
Link to section

gift_card_activity

Required

The activity to create for the gift card. This activity must specify gift_card_id or gift_card_gan for the target gift card, the location_id where the activity occurred, and the activity type along with the corresponding activity details.

Show attributes
Link to section

Response fields

Link to section

errors

Any errors that occurred during the request.

Show attributes
Link to section

gift_card_activity

The gift card activity that was created.

Show attributes

Error descriptions