Authenticate to the TempWorks OpenAPI and create/read a candidate record

domain: tempworks.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Get credentials: contact your TempWorks account manager for an AccountSid/AuthToken pair (Basic Auth) or register an application to get a client_id/client_secret for OAuth2.
  2. For automated/server integrations, request a bearer token as a 'Service' user by POSTing to https://login.ontempworks.com/connect/token with grant_type=tw_vendor_service_credentials, client_id, client_secret, and acr_values set to 'tenant:{tenant} pid:{product-instance-id}' (the tenant identifies the specific TempWorks customer, pid identifies your app instance for that customer).
  3. Alternatively use HTTP Basic Auth directly against the API with your AccountSid as username and AuthToken as password.
  4. Call the API against base URL https://api.ontempworks.com/, sending 'Authorization: Bearer {token}' if using OAuth2, or the x-tw-token header (base64 of AccountSid:AuthToken) if using token auth.
  5. To create a candidate, POST to the candidates endpoint with at minimum first name, last name, region (state), and branch — this endpoint intentionally bypasses assignment-restriction validation and marks the resulting record with an 'applied from web' status.
  6. To read candidate data, use the swagger/ReDoc reference at https://api.ontempworks.com/swagger or https://api.ontempworks.com/api-docs to find the exact candidate GET routes, and use documented query params (skip/take) for paging.

Known gotchas

Related routes

TempWorks OpenAPI: authenticate via OAuth2 (Service, Service Rep, or Web User flows)
tempworks.com · 5 steps · unrated
Authenticate to the JobDiva API and create/retrieve candidate records
jobdiva.com · 6 steps · unrated
Authenticate to the Remote.com API using OAuth2 client_credentials and create an employment record
developer.remote.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans