<- 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, create an ACTIVATE activity to activate a gift card with an initial balance before first use.

Permissions:GIFTCARDS_WRITE
Link to section

Request body

Example code

Link to section

idempotency_key

string

Required

A unique string that identifies the CreateGiftCardActivity request.

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.

Link to section

Response fields

Link to section

errors

Any errors that occurred during the request.

Link to section

gift_card_activity

The gift card activity that was created.

Error descriptions