Gift Card Activities

  • List gift card activities

  • Create gift card activity

  • Webhooks

  • gift_card.activity.created

  • gift_card.activity.updated

Development
  • Guides
  • API Reference
  • API Explorer
  • SDKs
  • Sample apps
  • System status
Support
  • Developer forums
  • Developer blog
  • YouTube
  • X
More
  • Square Home
  • Square Developer
  • App Marketplace
  • Partner with Square
  • Solutions Partner Program
  • Pricing
  • Sales

© 2026 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy
  • Partnerships
  • Sign In
  • Sign In

<- Gift Cards webhooks

Gift Cards webhooks

All versions ->

gift_card activity created

EVENT

 gift_card.activity.created

Published when a gift card activity is created.

Permissions:GIFTCARDS_READ
Link to section

Event payload

Example code

Link to section

merchant_id

string

The ID of the Square seller associated with the event.

Link to section

type

string

The type of event. For this event, the value is gift_card.activity.created.

Link to section

event_id

string

The unique ID of the event, which is used for idempotency support.

Link to section

created_at

string

Read only The timestamp of when the event was created, in RFC 3339 format.

Examples for January 25th, 2020 6:25:34pm Pacific Standard Time:

UTC: 2020-01-26T02:25:34Z

Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00

Link to section

data

The data associated with the event.

Link to section

Examples

All versions ->

Response JSON

{ "merchant_id": "C337NFWQT2A6W", "type": "gift_card.activity.created", "event_id": "875f2038-6015-492e-9f29-d040b3809e49", "created_at": "2020-12-17T03:41:35.157Z", "data": { "type": "gift_card_activity", "id": "gcact_c8f8cbf1f24b448d8ecf39ed03f97864", "object": { "gift_card_activity": { "id": "gcact_c8f8cbf1f24b448d8ecf39ed03f97864", "gift_card_id": "gftc:00113070ba5745f0b2377c1b9570cb03", "gift_card_gan": "7783320007480908", "type": "ACTIVATE", "gift_card_balance_money": { "amount": 1000, "currency": "USD" }, "location_id": "81FN9BNFZTKS4", "activate_activity_details": { "amount_money": { "amount": 1000, "currency": "USD" }, "order_id": "jJNGHm4gLI6XkFbwtiSLqK72KkAZY", "line_item_uid": "eIWl7X0nMuO9Ewbh0ChIx" }, "created_at": "2020-12-17T01:41:35.157Z" } } } }