Before you start

A Marxel organization admin account
A Workable Admin account

Check your access

Workable only lets Admin users generate API access tokens. Sign in with an Admin account or ask a Workable administrator to create a dedicated token for Marxel.

Marxel also needs an active recruiting member in the account when it posts screening notes or moves candidates. If the connection reports that no member is available, confirm that the account has an active recruiting or admin member.

Workable access token instructions

Create an API access token

1. In Workable, select your profile icon, then go to Settings, Integrations, Apps.
2. In API Access Tokens, select Generate API token. Give the token a clear name such as Marxel and choose an expiration.
3. Enable r_jobs, r_candidates, and w_candidates. These scopes let Marxel read jobs and candidates, register candidate updates, post screening notes, and move candidates.
4. Generate the token and copy it before you close the dialog. Workable does not display the full token again.
5. Copy your account subdomain. It is the first part of your signed-in Workable URL: for https://example.workable.com, enter example in Marxel.

Workable tokens use the expiration selected during creation. If a token expires, renew it in Workable to keep the same token value. If you replace or revoke it, reconnect Marxel with the new token.

See Workable's supported scopes and token controls and its subdomain guidance.

Connect Workable in Marxel

1. Open Organization settings, Integrations.
2. Find Workable. Enter the Subdomain without .workable.com, then paste the API token.
3. Select Connect. Marxel checks that the token can access the account and that an active member is available before saving the connection.

Credential handling

Marxel encrypts the Workable credentials before storing them. The access token is not returned to the browser after connection.

Confirm automatic updates

There is no separate webhook form to complete. During connection, Marxel registers Workable subscriptions for candidate_created and candidate_moved across all jobs and stages.

If Workable accepts the credentials but rejects subscription registration, Marxel marks the connection as needing attention. Recreate the token with the three required scopes, then reconnect.

Workable subscription API reference

Sync jobs and configure writeback

1. Open the Workable card menu in Marxel and select Sync jobs.
2. Review Post screening notes. When enabled, Marxel adds the screening summary, recommendation, and review link to the candidate timeline.
3. Select Configure beside stage movement. Map Aligned, Potential, Hold, and Unclear to the appropriate Workable stage for every synced job.
4. Enable Move candidates between stages after every synced job has complete mappings.

A safe rollout

Start with notes only, review a few screened candidates in Workable, then enable stage movement when the mappings match your hiring workflow.

Comment writeback reference Stage movement reference

Troubleshooting

Workable rejects the credentials

Enter only the first part of the Workable URL as the subdomain. Check that the token is active and was generated for the same account.

The token is missing permissions

Generate a new token with r_jobs, r_candidates, and w_candidates, then reconnect Marxel. All three are needed for synchronization, automatic candidate updates, notes, and stage movement.

Stage movement cannot be enabled

Run a job sync first, then complete all four Screening Bucket mappings for every synced job. Marxel keeps stage movement disabled until the mappings are complete.

The connection stopped after a subdomain change

Reconnect Workable using the new subdomain. Workable API calls using the previous account address will no longer succeed.

Ready to connect?

Keep this guide open while you create the Workable token and complete the integration card in Marxel.

Open integrations

Connect Workable to Marxel