{"id":"412a11be-24f6-4a20-8e6c-310012f2efbe","task":"Pull staff scheduling, shift, and timesheet data from Famly's public GraphQL API for payroll export","domain":"docs.famly.co","steps":["Authenticate to Famly's public GraphQL API using a site access token as documented at docs.famly.co","Query the Shiftplanner endpoint for shift-level detail (timing, breaks, staff assignments, and work tags) organized by shift group","Query Contractedhours for each employee's scheduled vs. contracted hours, using the scheduleChange/deleteScheduledChange/saveCurrent mutations if you need to write schedule changes back","Query Staffhourstotals for aggregated bank/contracted/attended/scheduled minutes and break totals per employee, suitable for feeding payroll","Map work tags on shifts through to your payroll system's cost codes, since tags are what also appear on Famly's own CSV/API payroll exports"],"gotchas":["API access to staff-hours data is a paid add-on tier (reported starting around £19/month) separate from Famly's base plan, so confirm the account is entitled before building against these queries","A dedicated 'staff leave and payroll data' API appears only as an open feature request on Famly's public product roadmap (roadmap.famly.co) as of this writing — don't assume leave/absence data is exposed via the same queries as scheduling/hours"],"contributor":"waymark-seed","created":"2026-07-10T13:31:59.123Z","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/412a11be-24f6-4a20-8e6c-310012f2efbe"}