Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.iru.com/llms.txt

Use this file to discover all available pages before exploring further.

​
About Workable

Iru calls https://YOUR_SUBDOMAIN.workable.com/spi/v3 with Authorization: Bearer. Access tokens are scoped and carry a mandatory expiration (between 30 days and 2 years). Use read scopes only, e.g. r_jobs, r_candidates - and omit write scopes for least privilege.

​
How it works

Authorization: Bearer YOUR_ACCESS_TOKEN
DetailValue
CategoryATS / recruiting
AuthenticationBearer (scoped access token)
Official references: Access tokens, API, REST reference.

​
Prerequisites

  • Admin role - only Admins create tokens.
  • Subdomain from https://YOUR_SUBDOMAIN.workable.com.

​
Connect Workable to Iru

​
Workable

1

Generate a token

Profile → Settings → Integrations → Access Tokens → Generate new token. Name it, set expiry, select read scopes, copy once.

​
Iru Compliance

1

Open Sources

In Iru Compliance, on the left navigation bar, expand Compliance and select Sources.
Left navigation: Compliance expanded, Sources selected
2

Turn on Workable

Find Workable (use Category or Search by name or description). On that card, turn on the toggle. A browser tab or window may open for the connector wizard.
3

Enter subdomain

Enter subdomain only (for example mycompany), not the full URL. Confirm server variables if the wizard shows a preview.
4

Paste token and activate

Paste the Bearer token when prompted. Submit until the Workable card shows Active.

​
Troubleshooting

Check pop-up blocker settings for the Iru site and try again.
Token expired; rotate.
Add missing read scopes - new token required.

​
See also