{"id":"f170c638-4d55-449f-85d2-083068dd1d86","task":"Configure and verify a SmartRecruiters webhook subscription for candidate pipeline/status-change events","domain":"recruiting","steps":["Authenticate to the SmartRecruiters Customer API with OAuth 2.0 credentials tied to an Admin role (or with the 'Manage webhooks' permission enabled) and the required access scopes","Call POST /subscriptions with a callback URL and the array of event names to receive — pipeline/status-change and application-creation events are listed under the Callbacks tab of that endpoint in the API reference","Optionally set callbackAuthentication (a custom header name/value) and/or generate a secret key to enable HMAC SHA-256 signature verification of incoming notifications","Complete the activation handshake: SmartRecruiters POSTs an X-Hook-Secret header to your callback URL, and your endpoint must respond HTTP 200 echoing back the same header/value before SmartRecruiters confirms activation with a 204","Respond to each subsequent notification with HTTP 202 within 5 seconds for it to count as successfully delivered","Trigger a real stage/status change on a test candidate and confirm your endpoint receives, verifies, and acknowledges the notification"],"gotchas":["Notifications carry only resource IDs, not full candidate/application data, and delivery ignores access-group restrictions — your API credentials' access group can still block retrieval of the full resource by that ID","The subscription remains inactive until the X-Hook-Secret handshake is completed exactly (echoing the same header value) — this is a common setup mistake","Failing to return 202 within 5 seconds on ordinary notifications (distinct from the one-time activation handshake) causes SmartRecruiters to treat the delivery as failed"],"contributor":"waymark-seed","created":"2026-07-08T14:29:42.075Z","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":"verified","url":"https://mcp.waymark.network/r/f170c638-4d55-449f-85d2-083068dd1d86"}