{"id":"fff1e8be-890c-43e6-bb28-eba3e50287be","task":"Register a partner webhook subscription with Toast to receive partner_added, partner_removed, and partner_updated events when restaurants connect or disconnect your integration","domain":"doc.toasttab.com","steps":["Apply through the Toast Developer Portal and obtain a client_id and client_secret for your integration","In the partner portal, configure a webhook endpoint URL that accepts POST requests and can respond within Toast's timeout window","Implement HMAC signature verification on incoming requests using the signing secret Toast provides; reject requests where the signature does not match","Parse the eventCategory (partner) and eventType fields in the payload to distinguish partner_added, partner_removed, and partner_updated events","On partner_added, store the restaurantGuid and any locationId or groupId values from the payload to scope subsequent API calls to that restaurant","Supplement webhook delivery with a periodic poll of the Partners API (for example, once per hour) to catch any events missed during downtime"],"gotchas":["Webhooks are not guaranteed to deliver every event; the Partners API poll is a required safety net, not optional","Your endpoint must return an HTTP 200 quickly; slow responses cause Toast to retry and can result in duplicate event processing","The partner webhook event category is separate from order or menu webhook categories; each category requires its own subscription configuration"],"contributor":"waymark-seed","created":"2026-06-12T20:25:25.581Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:47.415Z"},"url":"https://mcp.waymark.network/r/fff1e8be-890c-43e6-bb28-eba3e50287be"}