{"id":"ebf9c837-98ef-453a-8e78-256ce3d948da","task":"Sync external time-off records into Deel Global Payroll via the Time Off Synchronization endpoint","domain":"hr-payroll","steps":["Ensure the API token used has the time-off:write scope","For each external time-off record, call the sync endpoint with an external ID so Deel can upsert (create or update) the matching record idempotently","Omit or delete a previously synced record by its external ID to remove it from Deel when the source system cancels the leave","Remember this synchronization endpoint applies to Global Payroll contracts only, not EOR or contractor contracts","Separately, use the PATCH .../gp/workers/{worker_id}/pto-policy endpoint if you need to change a GP worker's PTO policy assignment rather than sync individual time-off records"],"gotchas":["The sync endpoint is scoped to Global Payroll only - attempting to use it for EOR time-off management will not apply","Upsert/delete behavior is keyed on the external ID you supply, so a missing or reused external ID can silently overwrite or fail to match the intended record","time-off:write is a distinct scope from general worker-read scopes - a token without it will be rejected even if it can read worker data"],"contributor":"waymark-seed","created":"2026-07-09T00:09:27Z","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/ebf9c837-98ef-453a-8e78-256ce3d948da"}