Authenticate to the JobDiva API and create/retrieve candidate records
domain: jobdiva.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Email support@jobdiva.com to request an API Client ID — JobDiva only issues this through direct support contact, not self-service.
In JobDiva, have a team leader create a dedicated API user under Settings > My Team > Add User, then under Assign User Permissions select 'Only allow to access JobDiva API Calls' so the account is scoped to API access only.
Use the Client ID plus the dedicated API user's username/password to obtain an access token from JobDiva's API (reference served at https://api.jobdiva.com/jobdiva-api.html).
To create a candidate, send a POST to /apiv2/jobdiva/createCandidate with at minimum firstName and lastName; optional fields include email, address, phone numbers, salary, education, skills, certifications, and user-defined fields. A successful call returns the new candidate's ID.
To retrieve a candidate, call the Get Candidate Details operation with required candidateId query parameter and optional userFieldsName.
To search/pull candidates in bulk, use Get Candidate Application Records with required fromDate/toDate query parameters formatted as MM/dd/yyyy HH:mm:ss, plus optional pageNumber/pageSize.
Known gotchas
JobDiva's current public candidate API is REST/JSON under /apiv2/jobdiva/ paths (not classic SOAP/WSDL) — but the primary reference page at api.jobdiva.com is a JS-rendered single-page app, so plain HTTP fetchers will see empty content; use a real browser or partner docs.
Date parameters use the specific MM/dd/yyyy HH:mm:ss string format, not ISO 8601 — ISO dates will likely fail silently or error.
Getting a Client ID requires a manual support request (support@jobdiva.com) — no self-serve developer portal/signup exists.
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?