Authenticate to the Assembled API using the credentials or API key provided in your Assembled account settings; check the current Assembled developer documentation for the exact authentication scheme as it may use an API key header or OAuth.
Query the forecast endpoint to retrieve forecasted staffing requirements for a given scheduling group, date range, and channel (voice, chat, email); the response includes per-interval forecasted agent requirements.
Query the actuals or schedule endpoint for the same date range to retrieve scheduled and actual agent counts; compute variance (forecasted minus actual) for each interval to identify overstaffed or understaffed periods.
Use the time-off API endpoints — which include auto-approval configuration, forecast adjustment, and forecast outlier management as recently added capabilities — to retrieve pending time-off requests and their approval status.
To submit or approve a time-off request programmatically, POST to the appropriate time-off endpoint with the agent ID, date range, and type; consult current Assembled docs as endpoint paths are subject to change.
Integrate forecast variance data into a business intelligence tool or alerting pipeline by scheduling regular pulls and comparing interval-level staffing gaps against defined thresholds.
Known gotchas
Assembled's public API surface is narrower than its UI capabilities; some workforce management operations (e.g., complex schedule editing) may only be available via the UI and not exposed through the API.
Forecast data granularity (15-minute vs. 30-minute vs. hourly intervals) depends on account configuration; confirm the interval size before building calculations that assume a fixed interval width.
Assembled's API documentation is not publicly indexed and requires account access to view; endpoint paths and request schemas should be verified against the current documentation rather than inferred from similar WFM platforms.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp