Events/Atelier
gift.sentBuyer-initiated

Gift sent

A buyer started a gift flow for a friend (a Gift row was created). Fires before the sender has paid; orderId is null on the payload.

When this fires

Fires whenever the underlying state change happens on the platform.

High frequency
This event is buyer-initiated, which means it can fire at checkout-traffic volume during busy periods. Make sure your handler responds in under ten seconds; queue any heavy work.

Sample payload

This is the exact envelope shape we POST to your endpoint — outer wrapper plus the per-event data payload. Field values are randomised on each render so you see the general shape, not a fixed example.

json
{
  "id": "848ce0db-7815-4adf-8224-25d5ead50bdb",
  "event": "gift.sent",
  "created": "2026-06-12T18:11:58.546Z",
  "data": {
    "message": "Sample payload not yet implemented for this event."
  }
}

Use cases

  • Trigger any downstream automation that cares about this state change.
  • Mirror the event into your data warehouse for analytics.
  • Notify a human channel for high-signal events.

Subscribe in the dashboard

To start receiving this event, add it to a webhook's subscription list in Developers → Webhooks. Wildcard subscriptions ( gift.*) work too — see the webhooks guide for the matching rules.