Retrieve candidate activity feed and add an interview in Ashby
domain: ashbyhq.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
GET https://api.ashbyhq.com/v1/candidate.search or use /v1/candidate.info to retrieve a candidate by ID or email; note the candidateId for subsequent calls.
To view the activity feed for a candidate, POST /v1/candidate.activityFeed with a body containing candidateId; the response lists all activities including notes, emails, and stage changes.
To schedule an interview, POST /v1/interview.create with applicationId, interviewStageId, startTime (ISO 8601), endTime, and interviewerUserIds array.
Retrieve valid interviewer IDs from /v1/user.list; interviewers must be active Ashby users.
Confirm the interview was created by POST /v1/interview.info with the returned interviewId.
To cancel the interview, POST /v1/interview.cancel with interviewId and an optional cancellationReason string.
Known gotchas
Ashby timestamps must be in ISO 8601 format with timezone offset; naive datetime strings (without timezone) are rejected.
Interview stage IDs and user IDs are UUIDs specific to your Ashby account; hardcoding them is fragile — fetch them dynamically before scheduling.
The activity feed is read-only via the API; adding notes to an activity feed requires a separate /v1/candidateNote.create call rather than writing to the feed directly.
Give your agent this knowledge — and 6,400+ more routes
One MCP install gives any agent live access to the full route map across 2,100+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp