--- title: Huntr API Integration on Truto slug: huntr category: ATS canonical: "https://truto.one/integrations/detail/huntr/" --- # Huntr API Integration on Truto **Category:** ATS **Status:** Beta ## MCP-ready AI tools Truto exposes 32 tools for Huntr that AI agents can call directly. - **list_all_huntr_organization_invitations** — List all pending Huntr organization invitations. Returns: id, toEmail, boardName, to, boardTemplate, memberFieldValues, createdAt. - **create_a_huntr_organization_invitation** — Create and send a Huntr organization invitation to a job seeker by email. Returns: id, createdAt, name, color, targetObjects. Required: email. An email with an existing pending invitation from your organization returns an error and no invitation is created. - **list_all_huntr_advisors** — List all advisors for your huntr organization. Returns each advisor's id, fullName, givenName, familyName, email, createdAt, and lastSeenAt. - **list_all_huntr_members** — List all members of your huntr organization. Returns: id, givenName, familyName, email, createdAt, lastSeenAt, isActive, memberFieldValues, memberFieldValuesKeyedById, advisor, boardIds. - **get_single_huntr_member_by_id** — Get a single member in your huntr organization by id. Returns: id, givenName, familyName, email, createdAt, lastSeenAt, isActive, memberFieldValues, memberFieldValuesKeyedById, advisor, boardIds. Required: id. - **huntr_members_bulk_update** — Update or set a member field value for a job seeker in huntr. Returns the updated member object including id, givenName, email, isActive, and memberFieldValues. Required: member_id, field_id, value. - **list_all_huntr_member_groups** — List all member groups in your huntr organization. Member groups are sets of members used to share job posts with job seekers and limit job post visibility on your job board. Returns: id, name, description, createdAt. - **list_all_huntr_member_fields** — List all Member Fields configured for your huntr organization. Returns: id, name, fieldType, choices. - **create_a_huntr_member_field** — Create a new Member Field in huntr for capturing custom member data, usable on the advisor dashboard and in organization invitations' memberFieldValues. Returns: id, name, fieldType, choices, text, htmlText, memberId. Required: name (must be unique in your organization) and fieldType; choices is required when fieldType is MULTIPLE_CHOICE or MULTIPLE_SELECT. Requests with a duplicate field name… - **list_all_huntr_candidates** — List all candidates in your huntr organization's talent portal. Returns a lightweight version of each candidate record: id, firstName, lastName, email, and memberId — use the get endpoint for the full profile. - **get_single_huntr_candidate_by_id** — Get a single candidate by id, returning the full talent-portal profile. Returns: id, memberId, firstName, lastName, email, emails, phoneNumber, phoneNumbers, headline, bio, profilePhotoUrl, backgroundPhotoUrl, currentLocation, timezone, totalWorkExperienceYears, skillNames, profiles, legallyAuthorizedToWorkInUsa, requireWorkVisaSponsorshipInUsa, experiencePreference, industryPreferencesNames,… - **list_all_huntr_board_templates** — List board templates in your huntr organization. Returns each template's id, name, isDefault flag, and listTemplates — the ordered stages used to create boards for members. - **list_all_huntr_jobs** — List all jobs tracked by members of your huntr organization. Returns each job's id, title, boardId, listId, salary, employer, ownerMember, activities, and createdAt. - **get_single_huntr_job_by_id** — Get a single job in huntr by id. Returns the full job record including id, title, salary, list, employer, ownerMember, activities, and offerActivity. Required: id. - **list_all_huntr_job_posts** — List all job posts added by advisors and staff to your huntr organization's internal job portal, sorted by creation date with the most recent first. Returns: id, title, htmlDescription, applicationInstructions, url, employerId, jobType, isRemote, salary, location, locations, jobPostStatus, creatorMember, ownerMember, employer, tags, postDate, createdAt, visibility, visibleMemberGroupIds. Max 500… - **get_single_huntr_job_post_by_id** — Get a single job post from your huntr organization's job portal by id. Returns: id, title, htmlDescription, applicationInstructions, url, employerId, jobType, isRemote, salary, location, locations, jobPostStatus, creatorMember, ownerMember, employer, tags, postDate, createdAt, visibility, visibleMemberGroupIds. Required: id. - **create_a_huntr_job_post** — Create a job post in your huntr organization's job portal. Returns the created job post including id, title, jobType, jobPostStatus, salary, locations, employer, and tags. Requires title, jobType, jobPostStatusName, and employer or employerId. A status of Open publishes the post to the portal; memberEntries queues asynchronous sharing with job seekers. - **huntr_job_posts_send_to_members** — Send existing job posts to job seekers' huntr boards as new Job cards. Returns a 200 OK acknowledgment; delivery is queued asynchronously and each delivery triggers a JOB_CREATED webhook action. Required: jobPostIds, memberEntries. - **create_a_huntr_tag** — Create a new tag in huntr with a display name, hex color, and the record types it can be applied to. Returns: id, name, description, color, targetObjects. Requires name, color, and targetObjects. - **list_all_huntr_tags** — List all tags created by your organization in huntr. Returns: id, name, description, color, targetObjects. - **list_all_huntr_activities** — List all activities for your huntr organization, sorted from most recently created to oldest. Each activity is classified into an Activity Category. Returns: id, title, note, completed, completedAt, startAt, endAt, createdAt, activityCategory, job, jobPost, employer, ownerMember, creatorMember, createdByWorkflow. - **list_all_huntr_activity_categories** — List all activity categories in huntr that classify member activities into a fixed set of job-search categories (e.g. Email, Phone Call, Phone Interview, Offer Received). Returns: id, name. Max 500 per page. - **list_all_huntr_actions** — List huntr actions for your organization, sorted from most recently created to oldest. Returns: id, actionType, date, createdByWorkflow, creatorMember, ownerMember, jobId, job, jobs, jobPostId, jobPostIds, jobPost, employerId, employer, employers, activityId, activity, activityCategory, boardId, noteId, note, contactId, contact, documentId, document, fromList, fromListId, toList, toListId,… - **list_all_huntr_goals** — List all goals in your huntr organization. Returns goal records including id, name, description, instructions, status, scheduleType, enrollmentStartDate, goalRecurrence, and firstGoalInterval/currentGoalInterval. By default, only active goals are returned. - **get_single_huntr_goal_by_id** — Get a specific goal in huntr by id. Returns the goal object including its id, name, status, scheduleType, objectiveEntity, objectiveNumericTarget, enrollmentType, goalRecurrence, and currentGoalInterval. Required: id. - **create_a_huntr_goal_enrollment** — Create a goal enrollment in huntr, enrolling a job seeker member in a goal. Returns the enrollment's id, goalId, status, startingGoalIntervalId, ownerMember, and startingGoalInterval. Required: goal_id, memberId. - **list_all_huntr_employers** — List huntr employers that your organization's members have added a job for. Returns: id, name, domain, foundedYear, description, location, isPartner, jobCount, applicationCount, interviewCount, offerCount. - **list_all_huntr_events** — List job lifecycle events (job added or moved, application/interview/offer dates set) for members in huntr. Returns: id, eventType, date, createdAt, member, job, toList, fromList. Deprecated — huntr recommends replacing Events with the Actions resource. - **list_all_huntr_candidate_action_metrics** — Retrieve action metrics for a specific candidate in huntr, broken down by employer and action type. Returns the CANDIDATE_PROFILE_VIEWED metrics with uniqueEmployersCt, totalCt, and an employers breakdown (id, name, domain, totalCt). Required: candidate_id. Currently the only action type returned is CANDIDATE_PROFILE_VIEWED. - **create_a_huntr_member_note** — Create an internal note for a member in huntr — visible to org staff on the member's profile in the admin dashboard. Returns: id, text, htmlText, memberId. Requires memberId and htmlText. - **delete_a_huntr_member_note_by_id** — Delete an internal member note in huntr by id. Returns the deleted note: id, text, htmlText, memberId. Required: id. - **list_all_huntr_member_notes** — List all internal member notes in huntr, sorted from most recently created to oldest. Returns: id, text, htmlText, memberId. ## How it works 1. **Link your customer's Huntr account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Huntr.** The Proxy API is a 1-to-1 mapping of the Huntr API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Auto-provision job seekers from your LMS or SIS** — EdTech platforms and student information systems can automatically invite graduating students into their school's Huntr workspace the moment they enter the career phase, eliminating manual CSV uploads and advisor onboarding work. - **Sync placement outcomes into your CRM or compliance tool** — Outcomes reporting and accreditation software (e.g., for CIRR compliance) can pull verified job search activity, interviews, and offers from Huntr to generate audit-proof placement reports without advisors re-entering data. - **Distribute partner jobs into bootcamp talent pools** — Employer partner networks and niche job boards can push open roles directly into a bootcamp's private Huntr job portal and route them to the right student cohorts, turning your platform into a talent distribution channel. - **Enrich advisor dashboards with external coaching signals** — Interview prep, resume review, and skill assessment platforms can post notes and activity data to a student's Huntr profile so career coaches see a unified view of readiness without switching tools. - **Programmatically assign and track job search goals** — Coaching and career-readiness apps can enroll members into Huntr goals (e.g., 'apply to 10 jobs a week') and monitor completion through activity data, keeping accountability loops tight across tools. ## What you can build - **Automated member invitation on lifecycle events** — Trigger a Huntr organization invitation whenever a student is marked 'graduated' or 'job-ready' in your system, provisioning their workspace instantly. - **Bulk member status sync** — Use bulk member updates to push custom field changes (e.g., 'Searching' → 'Placed') from your CRM into Huntr in a single call across cohorts. - **Internal job board publishing** — Create Huntr job posts from your platform and push them to targeted member groups so partner roles land directly on the right students' kanban boards. - **Coaching activity timeline** — Write member notes and read activity history to display a unified timeline of coach interactions, interviews, and application milestones inside your product. - **Outcomes reporting pipeline** — Pull actions, activities, and events on a schedule to compute time-to-hire, interview volume, and placement metrics for compliance or accreditation dashboards. - **Goal enrollment automation** — Programmatically enroll members into recurring job-search goals when they hit a milestone in your coaching or curriculum workflow. ## FAQs ### How does authentication to Huntr work through Truto? Truto handles the Huntr auth flow end-to-end. Your end users connect their Huntr organization account via Truto's hosted connect UI or your embedded flow, and Truto manages credential storage, refresh, and secure request signing so you never touch tokens directly. ### Can I write data back into Huntr, or is it read-only? Huntr integration is read/write. You can create organization invitations, job posts, tags, member notes, member fields, and goal enrollments, as well as bulk-update members and send job posts to specific members. ### How do I distribute a job post to specific job seekers? After creating a job post with create_a_huntr_job_post, call huntr_job_posts_send_to_members to push it directly into the personal kanban boards of targeted members. This runs asynchronously and emits a JOB_CREATED event when delivery completes. ### Can I sync custom fields on Huntr members? Yes. You can list existing member fields, create new custom member fields, and use the bulk member update endpoint to populate them from your system of record. ### What data is available for outcomes and compliance reporting? You can pull a full engagement history via list_all_huntr_actions, list_all_huntr_activities, list_all_huntr_events, and list_all_huntr_candidate_action_metrics. Together these cover interviews, offers, applications, and aggregated employer engagement signals suitable for CIRR-style reporting. ### How does Truto handle pagination and rate limits for Huntr? Truto normalizes Huntr's pagination behind consistent list endpoints and automatically handles retries and backoff when Huntr's rate limits are hit, so you can iterate large member, job, and activity datasets without writing custom throttling logic. ## Related reading - [Connect Huntr to AI Agents: Automate Recruitment & Goal Tracking](https://truto.one/blog/connect-huntr-to-ai-agents-automate-recruitment-and-goal-tracking/) — A complete engineering guide to connecting Huntr to AI agents using Truto's /tools endpoint. Build autonomous recruitment and goal tracking workflows.