Assembled

aid: assembled
name: Assembled
description: >-
  Assembled is a San Francisco-headquartered support operations platform that unifies workforce management (WFM), AI
  agents, and AI Copilot for modern customer support teams. Founded in 2020 by former Stripe operations engineers,
  Assembled lets support leaders plan, schedule, and orchestrate a hybrid workforce of in-house agents, BPO vendors, and
  AI agents from a single system. The platform delivers ML-based volume forecasting, automated schedule generation,
  real-time adherence, time-off and shift-swap automation, vendor capacity planning, multichannel routing, and
  structured reporting across phone, email, chat, SMS, social, and back-office channels. Its AI surface includes
  autonomous AI Agents that resolve customer conversations end-to-end across chat, email, SMS, and voice, plus AI
  Copilot, which drafts replies, translates in real time, and surfaces knowledge for human agents. The Assembled REST
  API (api.assembledhq.com/v0) exposes people, queues, sites, teams, skills, activities, agent states, forecasts,
  time-off requests, requirements, working hours, QA scores, structured reports, and the Assist endpoints for AI chat
  responses and knowledge articles. Assembled is used by Stripe, Etsy, Robinhood, Webflow, Canva, Duolingo, Autodesk,
  HubSpot, Intercom, and Ramp, and integrates with Zendesk, Salesforce Service Cloud, Intercom, Kustomer, Gladly,
  Gorgias, Dixa, ServiceNow, Five9, Genesys Cloud, Talkdesk, Amazon Connect, NiCE, UJET, Zoom Contact Center, Slack,
  Okta, Workday, HiBob, Google Calendar, Shopify, Notion, Confluence, Guru, SharePoint, Fivetran, and quality tools like
  Klaus, Rippit (MaestroQA), evaluagent, and Observe.AI.
url: https://raw.githubusercontent.com/api-evangelist/assembled/refs/heads/main/apis.yml
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
type: Index
kind: contract
position: Provider
access: 3rd-Party
tags:
  - Customer Support
  - Workforce Management
  - WFM
  - AI Agents
  - AI Copilot
  - Contact Center
  - Customer Experience
  - Support Operations
  - Scheduling
  - Forecasting
  - Quality Assurance
  - Vendor Management
  - BPO
created: '2026-05-24'
modified: '2026-05-24'
specificationVersion: '0.20'
apis:
  - aid: assembled:assembled-people-api
    name: Assembled People API
    tags:
      - People
      - Agents
      - Roles
      - Workforce Management
    humanURL: https://docs.assembled.com/
    properties:
      - url: https://docs.assembled.com/
        type: Documentation
      - url: openapi/assembled-people-api-openapi.yml
        type: OpenAPI
      - url: json-schema/assembled-person-schema.json
        type: JSONSchema
    description: >-
      Manage agents (people) in the Assembled workforce. List, retrieve, create, and update agents along with their
      roles, channels, skills, and team assignments. The People API is the entry point for syncing agents between
      Assembled and upstream HRIS, identity, and CRM systems and is the canonical reference for who can be scheduled or
      routed to in Assembled.
  - aid: assembled:assembled-agent-state-api
    name: Assembled Agent State API
    tags:
      - Agent State
      - Real-Time
      - Adherence
      - Operations
    humanURL: https://docs.assembled.com/
    properties:
      - url: https://docs.assembled.com/
        type: Documentation
      - url: openapi/assembled-agent-state-api-openapi.yml
        type: OpenAPI
    description: >-
      Read and write real-time agent state used to drive adherence reporting, live dashboards, and dynamic routing.
      Supports bulk state ingestion from upstream telephony and CRM platforms, a condensed non-overlapping timeline
      view, edit history, and platform-ID associations that link Assembled people to identities in Zendesk, Salesforce,
      Five9, and other integrated systems.
  - aid: assembled:assembled-activities-api
    name: Assembled Activities API
    tags:
      - Activities
      - Shifts
      - Scheduling
      - Workforce Management
    humanURL: https://docs.assembled.com/
    properties:
      - url: https://docs.assembled.com/
        type: Documentation
      - url: openapi/assembled-activities-api-openapi.yml
        type: OpenAPI
      - url: json-schema/assembled-activity-schema.json
        type: JSONSchema
    description: >-
      Create, list, and delete activities — the scheduled shifts, breaks, time off, training, and meetings that make up
      an agent's calendar. Includes bulk creation, soft-delete semantics, and management of activity types with their
      color coding. Companion event_changes endpoint surfaces the audit trail for schedule modifications.
  - aid: assembled:assembled-filters-api
    name: Assembled Filters API
    tags:
      - Queues
      - Sites
      - Teams
      - Skills
      - Organization
    humanURL: https://docs.assembled.com/
    properties:
      - url: https://docs.assembled.com/
        type: Documentation
      - url: openapi/assembled-filters-api-openapi.yml
        type: OpenAPI
    description: >-
      Manage the four organizational filter dimensions used throughout Assembled — Queues, Sites, Teams, and Skills.
      Each filter is fully CRUD-capable and is referenced by people, activities, forecasts, requirements, and reports.
      Queues map to channels and case types, Sites represent physical or virtual locations, Teams group people, and
      Skills describe routing-relevant capabilities.
  - aid: assembled:assembled-forecasts-api
    name: Assembled Forecasts API
    tags:
      - Forecasts
      - ML
      - Volume
      - Workforce Planning
    humanURL: https://docs.assembled.com/
    properties:
      - url: https://docs.assembled.com/
        type: Documentation
      - url: openapi/assembled-forecasts-api-openapi.yml
        type: OpenAPI
    description: >-
      Retrieve Assembled's ML-generated forecasts, forecast totals, manual adjustments, and detected outliers. The
      forecasted-vs-actuals endpoint compares predicted to realised volume so support leaders can tune models, identify
      drift, and validate >90% forecast accuracy claims. Forecasts drive AI-powered schedule generation and staffing
      recommendations across human and AI agents.
  - aid: assembled:assembled-time-off-api
    name: Assembled Time Off API
    tags:
      - Time Off
      - Leave
      - Workforce Management
    humanURL: https://docs.assembled.com/
    properties:
      - url: https://docs.assembled.com/
        type: Documentation
      - url: openapi/assembled-time-off-api-openapi.yml
        type: OpenAPI
    description: >-
      Programmatically create, list, and cancel time-off requests, and pull a stream of time-off updates for downstream
      HRIS or payroll synchronisation. The endpoint underpins the automated time-off and shift-swap workflows offered in
      Assembled's Pro and Enterprise plans.
  - aid: assembled:assembled-requirements-api
    name: Assembled Requirements API
    tags:
      - Requirements
      - Coverage
      - Staffing
    humanURL: https://docs.assembled.com/
    properties:
      - url: https://docs.assembled.com/
        type: Documentation
      - url: openapi/assembled-requirements-api-openapi.yml
        type: OpenAPI
    description: >-
      Create and list staffing requirements that express how many agents are needed by queue, site, team, or skill
      across time intervals. Requirement types describe the family of need (for example, headcount vs. occupancy
      targets). Requirements feed AI scheduling and real-time staffing recommendations.
  - aid: assembled:assembled-scheduling-rules-api
    name: Assembled Scheduling Rules API
    tags:
      - Scheduling
      - Working Hours
      - Rules
    humanURL: https://docs.assembled.com/
    properties:
      - url: https://docs.assembled.com/
        type: Documentation
      - url: openapi/assembled-scheduling-rules-api-openapi.yml
        type: OpenAPI
    description: >-
      Retrieve the working-hours rules that constrain when each agent may be scheduled. Working hours are the structured
      replacement for the now-deprecated shift_patterns endpoints and are honoured by Assembled's AI-powered schedule
      generation engine.
  - aid: assembled:assembled-conversations-api
    name: Assembled Conversations API
    tags:
      - Conversations
      - Channels
      - Customer Interactions
    humanURL: https://docs.assembled.com/
    properties:
      - url: https://docs.assembled.com/
        type: Documentation
      - url: openapi/assembled-conversations-api-openapi.yml
        type: OpenAPI
      - url: json-schema/assembled-conversation-schema.json
        type: JSONSchema
    description: >-
      Bulk-ingest and bulk-update customer conversation records — phone, email, chat, SMS, social, and back-office — so
      they can be associated with agents, queues, and channels for reporting, QA, and analytics. Used by customers
      running on non-Zendesk/Salesforce stacks or merging multiple CRMs into a unified support view.
  - aid: assembled:assembled-reports-api
    name: Assembled Reports API
    tags:
      - Reports
      - Analytics
      - Adherence
      - Handle Time
    humanURL: https://docs.assembled.com/
    properties:
      - url: https://docs.assembled.com/
        type: Documentation
      - url: openapi/assembled-reports-api-openapi.yml
        type: OpenAPI
    description: >-
      Asynchronously generate and retrieve structured reports including adherence, ticket statistics, and handle times.
      Reports are kicked off with a POST /v0/reports/:reportType call and polled via GET /v0/reports/:reportID for
      results, enabling automated weekly and monthly KPI exports into BI tools.
  - aid: assembled:assembled-qa-api
    name: Assembled QA API
    tags:
      - Quality Assurance
      - Scoring
      - Coaching
    humanURL: https://docs.assembled.com/
    properties:
      - url: https://docs.assembled.com/
        type: Documentation
      - url: openapi/assembled-qa-api-openapi.yml
        type: OpenAPI
    description: >-
      Upload QA scores in bulk so external quality-management tools such as Klaus, Rippit (MaestroQA), evaluagent, and
      Observe.AI can feed conversation scores back into Assembled for adherence-vs-quality analysis and coaching
      workflows.
  - aid: assembled:assembled-assist-api
    name: Assembled Assist API
    tags:
      - Assist
      - AI Copilot
      - AI Agents
      - Knowledge
    humanURL: https://docs.assembled.com/
    properties:
      - url: https://docs.assembled.com/
        type: Documentation
      - url: openapi/assembled-assist-api-openapi.yml
        type: OpenAPI
      - url: json-schema/assembled-assist-response-schema.json
        type: JSONSchema
    description: >-
      The AI surface of Assembled. Submit chat responses generated by AI Agents, manage the knowledge articles AI Agents
      draw from, retrieve conversation histories and handoff payloads, and (beta) post AI replies. Powers autonomous
      resolution across chat, email, SMS, and voice plus smart handoffs to human agents.
common:
  - type: PostmanWorkspace
    url: https://www.postman.com/kinlaneapi/assembled/overview
  - type: ArazzoWorkflows
    url: arazzo/
    workflows:
      - url: arazzo/assembled-agent-profile-update-workflow.yml
        name: Assembled Update an Agent Profile
        summary: Find an agent in the workforce, read their full profile, then patch their attributes.
      - url: arazzo/assembled-associate-agent-platforms-workflow.yml
        name: Assembled Associate Platform IDs to an Agent
        summary: Confirm an agent exists, map upstream platform identifiers to them, then read back the linked record.
      - url: arazzo/assembled-audit-schedule-changes-workflow.yml
        name: Assembled Audit Schedule Changes
        summary: List the activities scheduled in a window, then pull the audit trail of changes to them.
      - url: arazzo/assembled-cancel-time-off-workflow.yml
        name: Assembled Review and Cancel a Time Off Request
        summary: List pending time-off requests and cancel the first one, branching on whether any exist.
      - url: arazzo/assembled-forecast-to-requirement-workflow.yml
        name: Assembled Turn a Forecast into a Staffing Requirement
        summary: Read the volume forecast for a window, resolve a requirement type, then create a staffing requirement.
      - url: arazzo/assembled-generate-report-workflow.yml
        name: Assembled Generate and Retrieve a Report
        summary: Start an async report job, then fetch the result, branching on completion status.
      - url: arazzo/assembled-ingest-conversations-workflow.yml
        name: Assembled Ingest and Enrich Conversations
        summary: Bulk-upsert customer conversation records, then bulk-update them with enriched fields.
      - url: arazzo/assembled-manage-forecast-total-workflow.yml
        name: Assembled Create and Read a Forecast Total
        summary: Create a forecast total for a queue window, list totals to find it, then fetch it in full.
      - url: arazzo/assembled-provision-agent-workflow.yml
        name: Assembled Provision a New Agent
        summary: Resolve an available role, create a new agent, then read back the created record.
      - url: arazzo/assembled-provision-queue-and-staff-workflow.yml
        name: Assembled Provision a Queue and Staff It
        summary: Create a routing queue, pick an active agent, then schedule an activity routed to that queue.
      - url: arazzo/assembled-request-time-off-workflow.yml
        name: Assembled Request Time Off for an Agent
        summary: Confirm the agent exists, create a time-off request, then verify it in the request list.
      - url: arazzo/assembled-review-working-hours-workflow.yml
        name: Assembled Review an Agent's Working Hours
        summary: List the working-hours rules for an agent, then fetch the first rule in full.
      - url: arazzo/assembled-schedule-agent-shift-workflow.yml
        name: Assembled Schedule an Agent Shift
        summary: Resolve an activity type, create a scheduled activity, then list it back on the calendar.
      - url: arazzo/assembled-staff-agent-shift-workflow.yml
        name: Assembled Staff a Shift for a Workforce Agent
        summary: Pick an active agent from the workforce, then schedule a shift activity for them.
      - url: arazzo/assembled-stream-agent-state-workflow.yml
        name: Assembled Stream and Verify Agent State
        summary: Confirm an agent exists, push a batch of state records, then read back the condensed timeline.
  - type: Website
    url: https://www.assembled.com
  - type: Portal
    url: https://docs.assembled.com/
  - type: Documentation
    url: https://docs.assembled.com/
    name: Assembled API Reference
  - type: GettingStarted
    url: https://docs.assembled.com/
  - type: SignUp
    url: https://app.assembledhq.com/signup
  - type: Login
    url: https://app.assembledhq.com/login
  - type: Pricing
    url: https://www.assembled.com/pricing
  - type: Plans
    url: plans/assembled-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/assembled-rate-limits.yml
  - type: FinOps
    url: finops/assembled-finops.yml
  - type: StatusPage
    url: https://status.assembled.com
  - type: Blog
    url: https://www.assembled.com/blog
  - type: Customers
    url: https://www.assembled.com/customers
  - type: About
    url: https://www.assembled.com/about
  - type: Careers
    url: https://www.assembled.com/careers
  - type: Contact
    url: https://www.assembled.com/contact
  - type: Support
    url: https://support.assembled.com
  - type: PrivacyPolicy
    url: https://www.assembled.com/privacy
  - type: TermsOfService
    url: https://www.assembled.com/terms
  - type: TrustCenter
    url: https://trust.assembled.com
  - type: SecurityPolicy
    url: https://www.assembled.com/security
  - type: GitHubOrganization
    url: https://github.com/assembledhq
  - type: SDK
    url: https://github.com/assembledhq/assembled-chat-ios-sdk
    name: Assembled Chat iOS SDK
  - type: SDK
    url: https://github.com/assembledhq/assembled-chat-android-sdk
    name: Assembled Chat Android SDK
  - type: LinkedIn
    url: https://www.linkedin.com/company/assembledhq
  - type: Twitter
    url: https://twitter.com/assembledhq
  - type: YouTube
    url: https://www.youtube.com/@assembledhq
  - type: AppExchange
    url: https://appexchange.salesforce.com/appxListingDetail?listingId=22604eaa-c6cf-4357-bec0-297e4236345f
    name: Salesforce AppExchange Listing
  - type: Integrations
    url: https://www.assembled.com/integrations
  - type: Product
    url: https://www.assembled.com/products/workforce-management
    name: Workforce Management
  - type: Product
    url: https://www.assembled.com/products/ai-agents
    name: AI Agents
  - type: Product
    url: https://www.assembled.com/products/ai-copilot
    name: AI Copilot
  - type: Product
    url: https://www.assembled.com/products/vendor-management
    name: Vendor Management
  - type: JSONLD
    url: json-ld/assembled-context.jsonld
  - type: Vocabulary
    url: vocabulary/assembled-vocabulary.yml
  - type: SpectralRuleset
    url: rules/assembled-rules.yml
  - type: Features
    data:
      - ML-based forecasting with >90% accuracy across phone, email, chat, SMS, social, and back-office channels
      - AI-powered schedule generation that accounts for both human and AI agent coverage
      - Real-time adherence and live performance dashboards with intelligent case routing
      - Unified workforce management for in-house agents, BPO vendors, and AI agents
      - Automated time-off and shift-swap workflows (Pro and Enterprise)
      - Custom API integrations and white-glove onboarding (Enterprise)
      - AI Agents — autonomous multichannel resolution across chat, email, SMS, and voice with smart handoffs
      - AI Copilot — reply drafting, real-time translation, summarisation, agent guidance, and tone modifiers
      - Agentic workflows, escalation rules, custom style guides, and built-in QA tools for AI Agents
      - Vendor Management add-on with capacity planning, scheduling integration, coverage heatmaps, and billing reports
      - Structured reports for adherence, ticket statistics, and handle times via async report jobs
      - Quality assurance score ingestion from Klaus, Rippit (MaestroQA), evaluagent, Observe.AI
      - REST API at https://api.assembledhq.com/v0/ with HTTP Basic Auth (sk_live_ API keys)
      - Date-based API versioning via the API-Version request header
      - Default rate limit of 300 requests per minute (5 req/s) with bursts up to 20
      - Bulk operations supported across most write endpoints, plus soft-delete semantics
      - >-
        Native integrations across CCaaS (Five9, Genesys Cloud, Talkdesk, Amazon Connect, NiCE, UJET, Zoom),
        CRM/helpdesk (Zendesk, Salesforce, Intercom, Kustomer, Gladly, Gorgias, Dixa, ServiceNow), HRIS (Workday,
        HiBob), knowledge bases (Notion, Confluence, Guru, SharePoint, Google Drive), Fivetran data pipeline, Slack,
        Okta, Google Calendar, and Shopify
      - Official iOS and Android SDKs for embedding the Assembled chat widget into mobile applications
      - SOC 2, GDPR, and HIPAA compliance with enterprise-grade security and policy guardrails
      - Scheduling 4.5+ billion events per year for ~100,000 agents across 50+ countries (2025)
    sources:
      - https://www.assembled.com
      - https://www.assembled.com/pricing
      - https://www.assembled.com/integrations
      - https://docs.assembled.com/
      - https://github.com/assembledhq
    updated: '2026-05-24'
maintainers:
  - FN: Kin Lane
    email: info@apievangelist.com
    X: apievangelist
    url: https://apievangelist.com