Events/Atelier
friend.connectedBuyer-initiated

Friend connection accepted

Two buyers accepted a friend invite in The Atelier. Honour the agreed share level when reacting.

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": "6db0539d-da7c-40b4-bcf6-f4e47b7206c1",
  "event": "friend.connected",
  "created": "2026-06-12T18:11:59.386Z",
  "data": {
    "connectionId": "cwr70rpl4ss00000000000000",
    "buyerProfileId": "cfes5q6gylo80000000000000",
    "accepterBuyerProfileId": "crsb3fgsjpe80000000000000"
  }
}

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 ( friend.*) work too — see the webhooks guide for the matching rules.