Testing API calls
Before anything else, use our API explorer to test an API call. Follow the below steps:
- Open our full API documentation and locate the endpoint you wish to use, e.g. /jobs
- Click Test in the API Explorer
- In the window that appears, click the key icon and input Bearer followed by a space and then followed by the API key from the Integrations page.
- Add your subdomain in the respective field (required) or more filtering (state, limit)
- Click Try it and a response will expand
If you receive 200 OK (green dot) this means that everything works as expected. Otherwise, the dot will turn red and a descriptive error will appear to reveal the nature of the issue (authorization, wrong subdomain, etc).
Common issues/errors
401 Unauthorized error
This probably means that your API key was not added correctly. Make sure you add a space between Bearer and your API key.
429 error - 'You have exceeded the rate limits'
The request limit is 10 requests per 10 seconds. Make sure you implement your request accordingly.
CORS policy when using Javascript or jquery
Our API’s purpose is mostly for server-to-server communication and for this reason we do not support or encourage using it from the web browser (AJAX calls through javascript).
If it is necessary to access from the browser, there are alternate public endpoints that can be accessed through JSONP if you only need to access job information:
curl -L GET 'https://www.workable.com/api/accounts/<account_subdomain>?details=true'
curl -L GET 'https://www.workable.com/api/accounts/<account_subdomain>/locations'
curl -L GET 'https://www.workable.com/api/accounts/<account_subdomain>/departments'
Your account subdomain is the first part of the URL you see when signed in to Workable. The part “?details=true” means that you also want to fetch the job descriptions. The last two endpoints will fetch all locations and departments respectively.