Getting started with Workable

Updated:


January 11, 2024

To add Workable to your product with Unified.to, activate the Workable integration in your workspace and choose how customers authorize it: a Workable API token plus the account subdomain, or OAuth 2 with credentials that Workable issues to partners. Then embed the Authorization component and store the connection ID each customer creates. Workable is one of 2297 integrations on Unified.to. This guide is for developers and product teams adding Workable ATS and HR data to their product. It covers Unified.to's Workable integration from credentials to your first API call.

At the end of this guide, you will have everything you need to activate a Workable integration and begin creating customer connections in production.

What do you need before you start?

You need a Unified.to account. Start a 30-day free trial and follow the onboarding steps. Workable and all pre-built integrations are available on every Unified.to plan.

You also need to choose which Workable credential your customers will use. The API-token method needs nothing from Workable except a customer who is a Workable Admin. OAuth 2 needs partner credentials from Workable.

This guide assumes you know Workable and basic integration concepts. You don't need to be an expert in integration development or in Unified.to.

Should your customers use a Workable API token or OAuth 2?

Use the API token if you want to start now: each customer creates the token in their own Workable account. Use OAuth 2 once Workable has accepted you as a partner. Your customers then approve access on Workable's sign-in page, and Workable's API docs give OAuth tokens a higher rate limit. Unified.to's Workable integration supports both methods.

API token and subdomainOAuth 2
Who issues the credentialYour customer, in their own Workable account (Admin users only)Workable issues your client ID and client secret after it approves you as a partner; each customer then approves access
What your customer providesThe token and their account subdomainTheir account subdomain, then their Workable sign-in and approval of the requested scopes
What you enter in Unified.toNothing beyond activationYour Workable client ID and client secret
Workable rate limit10 requests per 10 seconds on account tokens. Calls that carry your Workable client ID get partner limits, and Unified.to sends it when you've entered one50 requests per 10 seconds on OAuth tokens
ExpiryThe customer picks 30 days, 90 days, 6 months, 1 year or 2 years. When it expires, the customer selects Renew in Workable, which keeps the same tokenAccess tokens last 7,200 seconds (2 hours); Unified.to uses the refresh token to renew them without asking the customer again
Workable facts in this table come from Workable's documentation, as of 21 October 2026. Workable counts requests per account or per OAuth application in 10-second windows, and returns HTTP 429 when a limit is exceeded.

How does a customer generate a Workable API token?

A Workable Admin generates the token from their profile icon under Settings > Integrations > Apps, in the API Access Tokens section (Workable Help Center, as of 21 October 2026). Workable has no separate API permission, so a user who isn't an Admin can't create one.

  1. Select the button to generate a new token, name it and choose an expiry.
  2. Select the scopes for the data your product uses.
  3. Copy the token. Workable shows it only once; if it's lost, the customer generates a new one.
  4. Find the account subdomain in Workable's company profile settings. It is the <subdomain> in https://<subdomain>.workable.com.

The customer enters both values when they connect Workable from your app. A token reaches only the Workable account it was created in, so a customer with two Workable accounts creates two tokens and two connections.

Ask customers to select the scopes that match the Unified.to objects you use. The Workable scope descriptions are from Workable's Help Center, as of 21 October 2026:

Workable scopeWhat Workable says it coversUnified.to objects that use it
r_candidatesCandidates, activities, offersCandidate, application, document, activity, scorecard
r_jobsJobs, stages, members, events, accountsJob, application status, interview, company
w_candidatesCreating and changing candidates, comments, copying candidates onto jobsWrites to candidates, applications, documents and activities
r_accountDepartmentsHR & Directory group
r_employeesEmployee records (Workable flags this scope as sensitive)HR & Directory employee
Native webhooks also need r_candidates (candidates) or r_employees (employees). If a customer can't find a scope you asked for, it isn't on Workable's token form: some scopes are only available to partner OAuth apps. When the token expires, the customer selects Renew in Workable. The token stays the same, so the connection keeps working. If a token is revoked instead, ask the customer to re-authorize the same connection with a new token. The connection keeps its ID.

How do you get Workable OAuth 2 credentials?

Workable issues OAuth 2 credentials only to official partners. Once Workable approves you, it gives you a client_id and client_secret (Workable OAuth documentation, as of 21 October 2026). There is no self-serve app registration.

  1. Apply to Workable's partnership program. As of 21 October 2026, Workable's 3rd Party Integration Partner tier has no mutual-customer minimum and accepts integrations built on a unified API; its Native Integration Partner tier requires at least 15 mutual customers.
  2. When Workable provisions your credentials, give it the Unified.to redirect URI for your workspace's region. Every authorization must use exactly the redirect URI you gave Workable at provisioning, so register each region you use:
    • US (every plan): https://api.unified.to/oauth/code
    • EU (Pro and Scale): https://api-eu.unified.to/oauth/code
    • AU (Pro and Scale): https://api-au.unified.to/oauth/code
  3. Ask Workable for the scopes your product needs. The OAuth 2 tab on Unified.to's Workable activation page lists the redirect URI and the Workable scopes for each Unified.to object. Request w_candidates only if you create or update candidates, applications or documents.
  4. In Unified.to, paste the client ID and client secret on the Workable activation page and select Activate.

With OAuth 2, the customer still enters their account subdomain. Workable access tokens last 7,200 seconds, and Unified.to renews them with the refresh token, which Workable replaces on every refresh. If a customer revokes access in Workable, ask them to re-authorize the same connection.

For help with a Workable partnership, email hello@unified.to or ask on Discord.

How do you activate Workable in Unified.to?

Sign in to app.unified.to, open Integrations, and search for Workable. You can also find it under the ATS or HR & Directory category.

Screenshot_2026-10-21_at_9.48.50_AM.png

Select Workable. On the authorization page, choose the categories (ATS, HR & Directory) and the authorization methods your customers can use: API token, OAuth 2 or both. For OAuth 2, enter your Workable client ID and client secret. Then select Activate.

Screenshot_2026-10-21_at_9.49.54_AM.png

Screenshot_2026-10-21_at_9.50.22_AM.png

Activation applies to the environment selected in app.unified.to. Activate Workable in each environment you use, such as Sandbox and Production, with that environment's credentials. As of 19 October 2026, activated integrations can't be copied between environments.

The Feature Support tab shows the objects and fields Unified.to's Workable integration supports. The same objects, methods and fields are listed publicly on the Workable integration page.

Screenshot_2026-10-21_at_9.50.48_AM.png

What can you read and write with a Workable connection?

As of 19 October 2026, Unified.to's Workable integration reads candidates, applications, jobs, documents, activities, interviews, scorecards, stages and companies in ATS, and employees and departments in HR & Directory. It writes candidates, applications, documents and activities.

Unified.to objectReadWriteChange events
CandidateList, GetCreate (needs a job), UpdateNative and virtual webhooks (created, updated)
ApplicationList, GetCreate, UpdateVirtual webhooks
JobList, GetNone (read-only)Virtual webhooks
DocumentList (by application), GetCreate, Update, RemoveNone
ActivityList (by candidate)CreateNone
InterviewList, GetNoneNone
ScorecardList (by candidate)NoneVirtual webhooks
Application status (stages)ListNoneNone
CompanyListNoneNone
HR & Directory employeeList, GetNoneNative webhooks
HR & Directory group (departments)List, GetNoneNone
For Workable endpoints outside these objects, use the Passthrough API (GET, POST, PUT, DELETE).

In Workable, a candidate is created on a job, and putting the same person on another job means creating the candidate again on that job, under a new Workable ID. See Workable: creating candidates and attaching them to jobs before you write candidates.

Assessment vendors use a separate integration, Workable Assessment (launched 6 February 2026). It is authorized with a Workable partner API key and handles assessment packages and orders.

How do Workable change events reach your app?

Candidate and employee changes can arrive as native webhooks, which Unified.to forwards as Workable sends them. Applications, jobs and scorecards use virtual webhooks, which check for changes at an interval you set, as often as every minute on paid plans; a check that finds nothing isn't billed. Candidates support both types. As of 20 October 2026, Unified.to lists created and updated events for Workable objects, not deleted events.

Workable's candidate_created event feeds Unified.to's native candidate created event, and only candidate_moved (a stage change) feeds native candidate updated; other candidate changes reach you through virtual webhooks.

Create webhooks in app.unified.to or with the webhooks API. See virtual webhooks for how checks and retries work. Native Workable webhooks need no setup in the customer's Workable account: Unified.to subscribes when you create the webhook. The connection must include r_candidates for candidate events or r_employees for employee events. Without them, webhook creation fails with "Failed to subscribe".

How do you add Workable to your app?

Add the Authorization component to your app, or build your own list of integrations with the API.

Workspace and environments. When you create a Unified.to account, Unified.to creates a workspace for you. A workspace holds environments, such as Sandbox, staging and production, and each environment has its own active integrations and credentials. You can add environments under Workspace Settings on any plan (set environments).

Workspace ID. The Authorization component needs your workspace ID. Find it under Settings > API Keys.

Authorization component. Open app.unified.to/embed, configure the Authorization component and copy its snippet into your app with your workspace ID. Components are available for React, Angular, Vue, Svelte and plain JavaScript. Select the permission scopes your product needs; if you leave them blank, Unified.to requests every scope the integration supports. The preview shows the Workable authorization page your customers see.

Your own front end. To build your own list, call GET /unified/integration/workspace/{workspace_id}, which returns all activated integrations in a workspace. Then send customers to the authorization URL from GET /unified/integration/auth/{workspace_id}/{integration_type}.

What happens after a customer connects Workable?

After a customer authorizes Workable, Unified.to redirects them to your success URL. The URL carries id (the connection ID), state, nonce, type and sig. Before you store anything, check sig against your workspace secret (embedded components).

Important: pass your own user or account ID in state. It comes back on the success URL with the connection ID, so you can store the two together.

From then on, call the API with that connection ID, for example GET /ats/{connection_id}/candidate. A connection is one customer's authorization of one integration.

How do you test without a Workable account?

Use the Sandbox (synthetic data) environment. Switch the environment in app.unified.to to Sandbox (synthetic data), activate Workable with any credentials, and create a test connection under Connections > Create test connection. Calls on that connection return synthetic data and don't reach Workable (sandbox environment).

To get mock data on a single request, send the header X-Mock: 1 with an empty Authorization header (mock server).

Which SDKs can you use?

SDKs are available for TypeScript, Python, PHP, Java, Go, C# and Ruby. Learn more.

Where to go next

Have a question? Complete this form or chat with us on Discord.

Share
All guidesHR APIsAccounting Account Type Hierarchy in UnifiedAdvertising Report Metrics by IntegrationAmazon S3: Required IAM PermissionsATS to Vector DB: How to Power Talent Intelligence with Real-Time DataBuilding AI applications with Unified and LangbaseConcur & Concur (Company) — Connection GuideConfigure Greenhouse Native Candidate WebhooksConfigure Salesforce Meetings and Notes for UnifiedConnect Amazon Seller Central to Unified.toConnecting BambooHR via OAuth 2Connecting Google Workspace Integrations with a Service AccountCorrect WelcomeKit Scopes for Jungle IntegrationCreating Ads using the Unified Ads APICreating Walmart Items via UnifiedEnd-Users, Integrations, and ConnectionsEnriching Unified Objects with Custom MetadataEnterprise-managed authorization (EMA) with a static keyEnterprise-managed authorization (EMA) with a workspace secretEnterprise-managed authorization (EMA) with Microsoft Entra IDExtended observability — pushing API logs to ClickHouseExtended observability — pushing API logs to Grafana / LokiExtended Observability - Pushing API Logs to your Datadog InstanceFacebook Messenger Webhook SetupFireflies Integration GuideHandling Delegated vs. Application Scopes in Microsoft IntegrationsHiBob & Unified: connection and time off guideHow long are logs retainedHow to access employees and usersHow to add API support for the Create Activity in CrelateHow to Associate a Connection ID with Your End-UserHow to build a Candidate Assessment product withHow to build a candidate sourcing or job board app with Unified.toHow to build a Discord support bot with Unified.to and LangbaseHow to Build a Fintech Application with Unified's Payments APIHow to Build an E-Commerce Product Integration with UnifiedHow to build an invoicing system with Unified.toHow to build Enterprise Search using RAGHow to configure Bullhorn Redirect URI for creating a connectionHow to configure webhooks in HubSpotHow to configure webhooks in Thrive LearningHow to configure webhooks in Toast for UnifiedHow to Connect Anthropic to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect Cohere to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect Google Gemini to Real-Time SaaS Data with Unified.to MCP ServerHow to connect HiBob (Bob) to Unified with OAuth 2.0How to Connect LLMs to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect OpenAI to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect Zoom and Zoom PhoneHow to create a Connection In Microsoft TeamsHow to create a token-based connection in HighlevelHow to Create a Unified.to Connection to HighLevelHow to Create a Xero Connection in Unified.toHow to create and configure webhooksHow to create Connection with HubspotHow to customize portal URLs for Stripe and GoCardlessHow to filter webhook eventsHow-to Get a Private Support Channel for Your Unified IntegrationHow to get help fromHow to get your 8x8 Connect API Key, Account ID and SMS Subaccount ID (optional): Step-by-step guideHow to get your ADP Workforce Now Oauth2 client ID, Oauth2 client secret, Oauth2 PEM certificate and Oauth2 private key: Step-by-step guideHow to get your Amazon S3 AWS Region, AWS S3 Key and AWS S3 Secret: Step-by-step guideHow to get your Ashby API Key: Step-by-step guideHow to get your Brex API token: Step-by-step guideHow to get your Bullhorn OAuth2 Client ID, OAuth2 Client Secret, API Username and API Password: Step-by-step guideHow to get your Ceridian Dayforce Username, Password and Client Namespace: Step-by-step guideHow to get your Crelate API key: Step-by-step guideHow to get your Dashlane API Key: Step-by-step guideHow to get your Deel Access Token: Step-by-step guideHow to get your Dialpad API Key: Step-by-step guideHow to get your Discord OAuth 2 credentials and bot tokenHow to get your ELMO client ID and client secret: Step-by-step guideHow to get your Gainsight Client ID, Client Secret and Gainsight API Domain: Step-by-step guideHow to get your Greenhouse API Key and Job board token: Step-by-step guideHow to get your Helpscout API Key: Step-by-step guideHow to get your HiBob Service User ID and Service User Token: Step-by-step guideHow to get your HighLevel API Key and Location ID: Step-by-step guideHow to get your HubSpot developer key and OAuth 2 credentials (Legacy Apps)How to get your Humaans API Key: Step-by-step guideHow to get your iCIMS API Username, API Password and Customer ID: Step-by-step guideHow to get your JobDiva Client ID, Username/email and Password: Step-by-step guideHow to get your Jobvite API Key, API Key Secret and Email: Step-by-step guideHow to get your Lever API Key: Step-by-step guideHow to get your Loxo Agency slug, API Key and Agency ID: Step-by-step guideHow to get your Microsoft Active Directory / Entra ID Client ID, Client Secret and Tenant ID: Step-by-step guideHow to get your Microsoft Azure AD OAuth 2 credentialsHow to get your OAuth 2 credentials for GmailHow to get your OAuth 2 credentials for Microsoft Dynamics 365How to get your OAuth 2 credentials in PipeDriveHow to get your OpenAI API Key: Step-by-step guideHow to get your Paycom SID/Username and Token/Password: Step-by-step guideHow to get your PCRecruiter Username, Password, Database ID, App Key and App ID: Step-by-step guideHow to get your SAP SuccessFactors (OpenID Connect) Username, Password, Client ID, Client Secret, Dependency Name, IAS Host and API URL: Step-by-step guideHow to get your SAP SuccessFactors Username, Company ID, Password and API URL: Step-by-step guideHow to get your Shopify Admin API access token and Store ID: Step-by-step guideHow to get your Wayfair Client ID, Client Secret and Vendor Encrypted Key: Step-by-step guideHow to get your Workable API Token and Subdomain: Step-by-step guideHow to get your yotpo APP Key / Store ID and Secret Key: Step-by-step guideHow to Handle Attachments in Invoice, Bill and Credit MemoHow to Manage Google Ad Manager Orders, Line Items and Creatives with theHow to migrate or import your integrations into Unified.toHow to obtain your GitHub OAuth2 credentialsHow to Power Claude with Live Customer Data Using Unified MCPHow to receive assessment orders from an ATS with Unified.toHow to register a Google developer app and get OAuth 2 credentialsHow to Register a HiBob Developer App and Get OAUTH2 CredentialsHow to register a Salesforce developer app and get OAuth 2 credentialsHow to register a Slack developer account and get OAuth 2 credentialsHow to Register a Workday Developer App and Get OAUTH2 CredentialsHow to Register a Workday Developer App and Get OAUTH2/ SOAP CredentialsHow to Register a ZendeskSell Developer App and Get OAUTH2 CredentialsHow to Register a Zoho Developer App and Get OAUTH2 CredentialsHow to Register an ADP Developer App and Get OAUTH2 CredentialsHow to Register an Atlassian Developer App and Get OAUTH2 CredentialsHow to Register your Facebook OAuth2 ApplicationHow to Register your Google Ads OAuth2 ApplicationHow to Register your MetaAds OAuth2 applicationHow To Request & Write Raw Integration DataHow to Retrieve Microsoft Dynamics 365 Business Central CredentialsHow to set up a custom API URL with a CNAMEHow to Set Up a Google Meet Meeting Bot with UnifiedHow to set up a HiBob marketplace installHow to Set Up a Microsoft Teams Bot with UnifiedHow to Set Up a Microsoft Teams Meeting Bot with UnifiedHow to Set Up a Webex Meeting Bot with UnifiedHow to Set Up a Zoom Meeting Bot with UnifiedHow to set up and configure NotionHow to set up Google Business Profile API access and get OAuth 2 credentialsHow to Set Up LinkedIn Webhooks with UnifiedHow to set up native webhooks for QuickBooks Online with UnifiedHow to set up Slack webhooks using event subscriptionsHow to set up Telegram (bot) with Unified.toHow to set up your scopes in HubSpotHow to setup a Freshbooks developer appHow to setup a TikTok Shop applicationHow to Setup AWS Assume Role for AWS Secret ManagerHow to setup Oracle JD EdwardsHow to Setup Quickbooks DesktopHow to setup Sage 100 with Unified.toHow to test webhooks in the Synthetic Data (Sandbox) environmentHow to troubleshoot unhealthy connectionsHow to troubleshoot unhealthy webhooksHow to Use Decision Models with the Unified GenAI APIHow to use SCIM with the Unified APIHow to use the Passthrough APIHow to Use Unified.to's Generative AI API with OpenAI and ClaudeHow to use User Provisioning and Verification with UnifiedHow virtual webhook retry and recovery worksIntegration set-up guide for LeverManaging custom validation rules in SalesforceNetSuite Authentication Setup for UnifiedNotice of Deprecation of Fields and Objects (Nov 2025)Oracle HCM / Taleo OAuth Credentials GuideRetrieval-Augmented Generation (RAG)SalesForce (External Client Apps) on Multiple OrganizationsSAML Single-Sign-OnScaling MCP Tools with Anthropic's (& OpenAI's) Defer LoadingScaling MCP Tools with Anthropic's Programmatic Tool CallingSet Environments for your Unified.to WorkspaceSetting up a Slack Bot Connection with Unified.toSetting up OAuth 2 Credentials for Greenhouse's APIsTrello Connection Guide in UnifiedUnderstanding OAuth2 Authorization flowsUnderstanding Response Time Headers in the Unified APIUnified Assessment API: Embed Assessments Inside ATS PlatformsUnified's MCP ServerUnified MCP Server with LangChain and LangGraphUnlock real-time data with virtual webhooksUse Unified to sign in your users into your applicationVincere OAuth Setup Guide for UnifiedWhy you can't use Unified's OAuth2 credentials to authorize your end users on ProductionWorkable: Creating candidates and attaching them to jobsWorkday vs Workday Legacy — Why Unified.to Supports BothWorking with hierarchical tree data in Storage, Messaging, and KMS APIs
Are we missing anything? Let us know
Was this page helpful?