Integration Options
Worksome offers multiple ways to integrate with the platform, from no-code automation to full programmatic API access. Choose the method that fits your technical resources and use case.
Choosing an integration method
| Method | Best for | Technical level | API coverage | Auth method |
|---|---|---|---|---|
| GraphQL API | Full programmatic access, custom integrations | Developer | Full | OAuth 2.0 or PAT |
| Webhooks | Real-time event notifications when data changes | Developer | Outbound events only | Shared secret (HMAC) |
| CLI | Command-line access, scripting, AI agent tooling | Developer / AI agent | Broad (170+ operations) | PAT |
| PHP SDK | PHP applications with convenient helpers | PHP developer | Partial (wrapper over GraphQL) | PAT |
| Zapier | No-code automation connecting Worksome to 6,000+ apps | Non-technical | Limited | OAuth 2.0 |
| MCP Server | AI assistant integration (Claude, ChatGPT, custom LLMs) | AI agent | Early access — request access | OAuth 2.0 or PAT |
| AI-Ready Docs | Feed documentation directly into LLMs and AI agents | AI agent / Developer | Documentation only | None |
Quick start by use case
“I want to sync Worksome data with another tool”
If the other tool is on Zapier, start with Zapier. If not, or if you need more control, use the GraphQL API with Webhooks for real-time updates.
“I want to build a custom integration”
Use the GraphQL API directly. Start with Authentication to get a Personal Access Token, then follow the Getting Started guide.
“I want to automate workflows with scripts”
The CLI provides full API access from the command line. It supports JSON output, piping, and is designed for scripting and automation.
“I want to connect an AI agent to Worksome”
Three options are available depending on what your agent needs:
- MCP Server — Purpose-built for AI assistants like Claude and ChatGPT. Provides structured tools for querying and mutating Worksome data via natural language.
- CLI — Full API coverage with JSON output mode, designed for AI agent tooling and scripting.
- AI-Ready Documentation — Machine-readable documentation files (
llms.txtandllms-full.txt) that can be fed directly into an LLM’s context window for grounded answers about the Worksome API.
“I have a PHP application”
The PHP SDK provides a convenient wrapper over the GraphQL API with helper methods for common operations.
Integration methods
GraphQL API
The core of all Worksome integrations. A single endpoint (https://api.worksome.com/graphql) for querying and mutating data — hires, contracts, invoices, workers, compliance, and more. See Getting Started with GraphQL.
Webhooks
Receive real-time HTTP callbacks when events occur — contracts accepted, hires updated, invoices created. See Getting Started with Webhooks.
CLI
A Go-based command-line tool with broad API coverage (60+ resource groups, 170+ operations). Supports JSON output, piping, dry-run mode, and multiple authentication profiles. See CLI.
PHP SDK
An open-source PHP package for the Worksome API with helper methods for authentication, viewer info, and raw GraphQL queries. See PHP SDK.
Zapier
No-code automation connecting Worksome to Slack, Google Sheets, HubSpot and thousands more. The available triggers and actions are listed on the Zapier app page. See Zapier.
MCP Server
A Model Context Protocol server that lets AI assistants interact with Worksome through natural language. Tools map one-to-one to public GraphQL API operations and cover hires, jobs, candidates, payments, invoices, timesheets, contracts, approvals, webhooks, and more. See MCP Server.
AI-Ready Documentation
Machine-readable documentation files designed for LLMs and AI agents. These follow the emerging llms.txt convention and can be loaded directly into an AI agent’s context window. See AI Agents.
What can you integrate?
| Data | Read | Write | Webhooks |
|---|---|---|---|
| Hires | Query hires by status, company, worker | Create draft hires | Contract accepted, hire updated, cancelled, ended, terminated |
| Contracts | Query contracts by status, currency | Created via draft hire flow | Contract accepted |
| Workers | Query workers through hires | — | Trusted contact updated |
| Invoices | Query invoices by status, date, currency | — | — |
| Jobs | Query jobs | Create jobs (API, Zapier) | New job (Zapier) |
| Compliance | Query compliance status, gates, classification | — | — |
Need help?
If you’re unsure which integration method fits your needs, contact your Worksome account representative. For technical support, visit the Support page.