Greenhouse

Greenhouse Candidate Tags API

The Candidate Tags API from Greenhouse — 2 operation(s) for candidate tags.

GitHub OpenAPI

Operations 3

POST /v3/candidate_tags Create Candidate Tag #
GET /v3/candidate_tags List candidate tags #
DELETE /v3/candidate_tags/{id} Delete Candidate Tags #

Documentation

📖
Documentation
https://onboarding-api.greenhouse.io/api-docs/index.html
📖
Documentation
https://developers.greenhouse.io/gho.html
📖
Documentation
https://harvestdocs.greenhouse.io/docs/authentication
📖
Documentation
https://harvestdocs.greenhouse.io/reference/generate-token
📖
Documentation
https://harvestdocs.greenhouse.io/
📖
Documentation
https://harvestdocs.greenhouse.io/docs/api-rate-limiting
📖
Documentation
https://harvestdocs.greenhouse.io/docs/pagination

Specifications

⚙
OpenAPI
https://artifacts.apis.io/greenhouse/openapi/greenhouse-candidate-tags-api-openapi.yml

Other Resources

🔗
LLMsTxt
https://artifacts.apis.io/greenhouse/llms/greenhouse-harvestdocs-llms.txt

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/greenhouse:greenhouse-candidate-tags-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

greenhouse-candidate-tags-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Greenhouse Candidate Tags API
  version: v3
  description: 'Operations tagged Candidate Tags across 2 of this provider''s published API definitions: greenhouse-harvest-v3-openapi.json, greenhouse-harvest-v3-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://harvest.greenhouse.io
security:
- bearer: []
tags:
- name: Candidate Tags
paths:
  /v3/candidate_tags:
    post:
      summary: Create Candidate Tag
      tags:
      - Candidate Tags
      security:
      - oauth2:
        - harvest:candidate_tags:create
      - bearer: []
      parameters: []
      responses:
        '201':
          description: Successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                properties:
                  id:
                    type: integer
                  created_at:
                    type: string
                    format: date-time
                  updated_at:
                    type: string
                    format: date-time
                  name:
                    type: string
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '422':
          description: Validation Error
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - name
              properties:
                name:
                  type: string
                  maxLength: 255
                  minLength: 1
      operationId: postV3CandidateTags
      x-operation-id-source: derived
    get:
      summary: List candidate tags
      tags:
      - Candidate Tags
      security:
      - oauth2:
        - harvest:candidate_tags:list
      - bearer: []
      parameters:
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        description: Cursor link for pagination from previous page response header. Do not use any other parameters when using this.
      - name: per_page
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 500
          default: 100
        description: Number of results per page
      - name: ids
        in: query
        required: false
        description: Comma separated list
        style: form
        explode: false
        schema:
          type: array
          items:
            type: integer
          maxItems: 50
      - name: created_at
        in: query
        required: false
        schema:
          type: object
          properties:
            gte:
              type: string
              format: date-time
            lte:
              type: string
              format: date-time
            gt:
              type: string
              format: date-time
            lt:
              type: string
              format: date-time
        style: pipeDelimited
      - name: updated_at
        in: query
        required: false
        schema:
          type: object
          properties:
            gte:
              type: string
              format: date-time
            lte:
              type: string
              format: date-time
            gt:
              type: string
              format: date-time
            lt:
              type: string
              format: date-time
        style: pipeDelimited
      - name: fields
        in: query
        required: false
        description: Comma separated list of fields to return
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
            pattern: (?i-mx:^(?i-mx:[a-z]+(?:_[a-z]+)*)+(?:,(?i-mx:[a-z]+(?:_[a-z]+)*)+)*$)
          maxItems: 50
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                example_response:
                  value:
                  - id: 1545802
                    created_at: '2024-01-01T12:30:30.000Z'
                    updated_at: '2024-01-01T12:30:30.000Z'
                    name: Cool as a Cucumber
              schema:
                type: array
                uniqueItems: true
                items:
                  type: object
                  additionalProperties: false
                  properties:
                    id:
                      type: integer
                    created_at:
                      type: string
                      format: date-time
                    updated_at:
                      type: string
                      format: date-time
                    name:
                      type: string
      operationId: getV3CandidateTags
      x-operation-id-source: derived
    servers:
    - url: https://harvest.greenhouse.io
  /v3/candidate_tags/{id}:
    delete:
      summary: Delete Candidate Tags
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Candidate Tags
      security:
      - oauth2:
        - harvest:candidate_tags:destroy
      - bearer: []
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                example_response:
                  value:
                    message: Candidate Tag 1537400 deleted successfully
              schema:
                type: object
                additionalProperties: false
                properties:
                  id:
                    type: integer
                  created_at:
                    type: string
                    format: date-time
                  updated_at:
                    type: string
                    format: date-time
                  message:
                    type: string
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      operationId: deleteV3CandidateTagsById
      x-operation-id-source: derived
    servers:
    - url: https://harvest.greenhouse.io
components:
  securitySchemes:
    basic_auth:
      description: API Credential
      type: http
      scheme: basic
    bearer:
      description: JWT access_token from /auth/token
      type: http
      scheme: bearer
      bearerFormat: JWT
    oauth2:
      type: oauth2
      description: OAuth2 Authentication
      flows:
        clientCredentials:
          tokenUrl: https://auth.greenhouse.io/token
          scopes:
            harvest:application_stages:list: List application stages
            harvest:applications:list: List applications
            harvest:applications:destroy: Destroy applications
            harvest:applications:create: Create applications
            harvest:applications:update: Update applications
            harvest:applications:hire: Hire applications
            harvest:applications:convert_to_candidate: Convert to candidate applications
            harvest:applications:reject: Reject applications
            harvest:applications:unreject: Unreject applications
            harvest:applications:move: Move applications
            harvest:applied_candidate_tags:list: List applied candidate tags
            harvest:applied_candidate_tags:create: Create applied candidate tags
            harvest:applied_candidate_tags:destroy: Destroy applied candidate tags
            harvest:approval_flows:list: List approval flows
            harvest:approval_flows:create: Create approval flows
            harvest:approval_flows:update: Update approval flows
            harvest:approval_flows:request_approvals: Request approvals
            harvest:approval_flows:replace_approver_groups: Replace approver groups
            harvest:approver_groups:list: List approver groups
            harvest:approver_groups:replace_approver: Replace approvers
            harvest:approvers:list: List approvers
            harvest:attachments:list: List attachments
            harvest:attachments:create: Create attachments
            harvest:attachments:destroy: Destroy attachments
            harvest:bulk_requests:list: List bulk requests
            harvest:candidate_attribute_types:list: List candidate attribute types
            harvest:candidate_educations:list: List candidate educations
            harvest:candidate_educations:destroy: Destroy candidate educations
            harvest:candidate_educations:create: Create candidate educations
            harvest:candidate_employments:list: List candidate employments
            harvest:candidate_employments:destroy: Destroy candidate employments
            harvest:candidate_employments:create: Create candidate employments
            harvest:candidate_tags:list: List candidate tags
            harvest:candidate_tags:create: Create candidate tags
            harvest:candidate_tags:destroy: Destroy candidate tags
            harvest:candidates:list: List candidates
            harvest:candidates:create: Create candidates
            harvest:candidates:destroy: Destroy candidates
            harvest:candidates:update: Update candidates
            harvest:candidates:merge: Merge candidates
            harvest:candidates:anonymize: Anonymize candidates
            harvest:close_reasons:list: List close reasons
            harvest:custom_field_departments:list: List custom field departments
            harvest:custom_field_departments:create: Create custom field departments
            harvest:custom_field_departments:destroy: Destroy custom field departments
            harvest:custom_field_offices:list: List custom field offices
            harvest:custom_field_offices:create: Create custom field offices
            harvest:custom_field_offices:destroy: Destroy custom field offices
            harvest:custom_field_options:list: List custom field options
            harvest:custom_field_options:create: Create custom field options
            harvest:custom_field_options:destroy: Destroy custom field options
            harvest:custom_field_options:update: Update custom field options
            harvest:custom_fields:list: List custom fields
            harvest:custom_fields:destroy: Destroy custom fields
            harvest:custom_fields:create: Create custom fields
            harvest:custom_fields:update: Update custom fields
            harvest:default_interviewers:list: List default interviewers
            harvest:demographic_answer_options:list: List demographic answer options
            harvest:demographic_answers:list: List demographic answers
            harvest:demographic_question_sets:list: List demographic question sets
            harvest:demographic_questions:list: List demographic questions
            harvest:departments:list: List departments
            harvest:departments:create: Create departments
            harvest:departments:update: Update departments
            harvest:eeoc:list: List eeoc
            harvest:email_templates:list: List email templates
            harvest:focus_candidate_attributes:list: List focus candidate attributes
            harvest:future_job_permissions:list: List future job permissions
            harvest:future_job_permissions:create: Create future job permissions
            harvest:future_job_permissions:destroy: Destroy future job permissions
            harvest:interview_kits:list: List interview kits
            harvest:interviewer_tags:list: List interviewer tags
            harvest:interviewers:list: List interviewers
            harvest:interviews:list: List interviews
            harvest:interviews:create: Create interviews
            harvest:interviews:destroy: Destroy interviews
            harvest:interviews:update: Update interviews
            harvest:job_board_custom_locations:list: List job board custom locations
            harvest:job_candidate_attributes:list: List job candidate attributes
            harvest:job_hiring_managers:list: List job hiring managers
            harvest:job_hiring_managers:create: Create job hiring managers
            harvest:job_hiring_managers:destroy: Destroy job hiring managers
            harvest:job_interview_stages:list: List job interview stages
            harvest:job_interviews:list: List job interviews
            harvest:job_notes:list: List job notes
            harvest:job_notes:create: Create job notes
            harvest:job_notes:destroy: Destroy job notes
            harvest:job_notes:update: Update job notes
            harvest:job_owners:list: List job owners
            harvest:job_owners:create: Create job owners
            harvest:job_owners:destroy: Destroy job owners
            harvest:job_post_locations:list: List job post locations
            harvest:job_post_locations:create: Create job post locations
            harvest:job_post_locations:destroy: Destroy job post locations
            harvest:job_posts:list: List job posts
            harvest:job_posts:update: Update job posts
            harvest:jobs:list: List jobs
            harvest:jobs:create: Create jobs
            harvest:jobs:update: Update jobs
            harvest:notes:list: List notes
            harvest:notes:create: Create notes
            harvest:offers:list: List offers
            harvest:offers:create: Create offers
            harvest:offers:update: Update offers
            harvest:offices:list: List offices
            harvest:offices:create: Create offices
            harvest:offices:update: Update offices
            harvest:openings:list: List openings
            harvest:openings:create: Create openings
            harvest:openings:destroy: Destroy openings
            harvest:openings:update: Update openings
            harvest:prospect_details:list: List prospect details
            harvest:prospect_pool_stages:list: List prospect pool stages
            harvest:prospect_pools:list: List prospect pools
            harvest:referrers:list: List referrers
            harvest:rejection_details:list: List rejection details
            harvest:rejection_details:update: Update rejection details
            harvest:rejection_reasons:list: List rejection reasons
            harvest:scorecard_candidate_attributes:list: List scorecard candidate attributes
            harvest:scorecard_candidate_attributes:create: Create scorecard candidate attributes
            harvest:scorecard_candidate_attributes:update: Update scorecard candidate attributes
            harvest:scorecard_question_answer_options:create: Create scorecard question answer options
            harvest:scorecard_question_answer_options:list: List scorecard question answer options
            harvest:scorecard_question_answers:list: List scorecard question answers
            harvest:scorecard_question_answers:create: Create scorecard question answers
            harvest:scorecard_question_answers:update: Update scorecard question answers
            harvest:scorecard_question_candidate_attributes:list: List scorecard question candidate attributes
            harvest:scorecard_question_options:list: List scorecard question options
            harvest:scorecard_questions:list: List scorecard questions
            harvest:scorecards:list: List scorecards
            harvest:scorecards:create: Create scorecards
            harvest:scorecards:update: Update scorecards
            harvest:sources:list: List sources
            harvest:tracking_links:list: List tracking links
            harvest:user_emails:list: List user emails
            harvest:user_emails:create: Create user emails
            harvest:user_job_permissions:list: List user job permissions
            harvest:user_job_permissions:create: Create user job permissions
            harvest:user_job_permissions:destroy: Destroy user job permissions
            harvest:user_roles:list: List user roles
            harvest:users:list: List users
            harvest:users:create: Create users
            harvest:users:update: Update users
            harvest:users:deactivate: Deactivate users
            harvest:users:activate: Activate users
            harvest:users:revoke_permissions: Revoke permissions users
            harvest:webhooks:create: Create webhooks
            harvest:webhooks:update: Update webhooks
            harvest:webhooks:destroy: Destroy webhooks
            harvest:webhooks:list: List webhooks
            auditlog:events:list: List audit log events
        authorizationCode:
          authorizationUrl: https://auth.greenhouse.io/authorize
          tokenUrl: https://auth.greenhouse.io/token
          refreshUrl: https://auth.greenhouse.io/token
          scopes:
            harvest:application_stages:list: List application stages
            harvest:applications:list: List applications
            harvest:applications:destroy: Destroy applications
            harvest:applications:create: Create applications
            harvest:applications:update: Update applications
            harvest:applications:hire: Hire applications
            harvest:applications:convert_to_candidate: Convert to candidate applications
            harvest:applications:reject: Reject applications
            harvest:applications:unreject: Unreject applications
            harvest:applications:move: Move applications
            harvest:applied_candidate_tags:list: List applied candidate tags
            harvest:applied_candidate_tags:create: Create applied candidate tags
            harvest:applied_candidate_tags:destroy: Destroy applied candidate tags
            harvest:approval_flows:list: List approval flows
            harvest:approval_flows:create: Create approval flows
            harvest:approval_flows:update: Update approval flows
            harvest:approval_flows:request_approvals: Request approvals
            harvest:approval_flows:replace_approver_groups: Replace approver groups
            harvest:approver_groups:list: List approver groups
            harvest:approver_groups:replace_approver: Replace approvers
            harvest:approvers:list: List approvers
            harvest:attachments:list: List attachments
            harvest:attachments:create: Create attachments
            harvest:attachments:destroy: Destroy attachments
            harvest:bulk_requests:list: List bulk requests
            harvest:candidate_attribute_types:list: List candidate attribute types
            harvest:candidate_educations:list: List candidate educations
            harvest:candidate_educations:destroy: Destroy candidate educations
            harvest:candidate_educations:create: Create candidate educations
            harvest:candidate_employments:list: List candidate employments
            harvest:candidate_employments:destroy: Destroy candidate employments
            harvest:candidate_employments:create: Create candidate employments
            harvest:candidate_tags:list: List candidate tags
            harvest:candidate_tags:create: Create candidate tags
            harvest:candidate_tags:destroy: Destroy candidate tags
            harvest:candidates:list: List candidates
            harvest:candidates:create: Create candidates
            harvest:candidates:destroy: Destroy candidates
            harvest:candidates:update: Update candidates
            harvest:candidates:merge: Merge candidates
            harvest:candidates:anonymize: Anonymize candidates
            harvest:close_reasons:list: List close reasons
            harvest:custom_field_departments:list: List custom field departments
            harvest:custom_field_departments:create: Create custom field departments
            harvest:custom_field_departments:destroy: Destroy custom field departments
            harvest:custom_field_offices:list: List custom field offices
            harvest:custom_field_offices:create: Create custom field offices
            harvest:custom_field_offices:destroy: Destroy custom field offices
            harvest:custom_field_options:list: List custom field options
            harvest:custom_field_options:create: Create custom field options
            harvest:custom_field_options:destroy: Destroy custom field options
            harvest:custom_field_options:update: Update custom field options
            harvest:custom_fields:list: List custom fields
            harvest:custom_fields:destroy: Destroy custom fields
            harvest:custom_fields:create: Create custom fields
            harvest:custom_fields:update: Update custom fields
            harvest:default_interviewers:list: List default interviewers
            harvest:demographic_answer_options:list: List demographic answer options
            harvest:demographic_answers:list: List demographic answers
            harvest:demographic_question_sets:list: List demographic question sets
            harvest:demographic_questions:list: List demographic questions
            harvest:departments:list: List departments
            harvest:departments:create: Create departments
            harvest:departments:update: Update departments
            harvest:eeoc:list: List eeoc
            harvest:email_templates:list: List email templates
            harvest:focus_candidate_attributes:list: List focus candidate attributes
            harvest:future_job_permissions:list: List future job permissions
            harvest:future_job_permissions:create: Create future job permissions
            harvest:future_job_permissions:destroy: Destroy future job permissions
            harvest:interview_kits:list: List interview kits
            harvest:interviewer_tags:list: List interviewer tags
            harvest:interviewers:list: List interviewers
            harvest:interviews:list: List interviews
            harvest:interviews:create: Create interviews
            harvest:interviews:destroy: Destroy interviews
            harvest:interviews:update: Update interviews
            harvest:job_board_custom_locations:list: List job board custom locations
            harvest:job_candidate_attributes:list: List job candidate attributes
            harvest:job_hiring_managers:list: List job hiring managers
            harvest:job_hiring_managers:create: Create job hiring managers
            harvest:job_hiring_managers:destroy: Destroy job hiring managers
            harvest:job_interview_stages:list: List job interview stages
            harvest:job_interviews:list: List job interviews
            harvest:job_notes:list: List job notes
            harvest:job_notes:create: Create job notes
            harvest:job_notes:destroy: Destroy job notes
            harvest:job_notes:update: Update job notes
            harvest:job_owners:list: List job owners
            harvest:job_owners:create: Create job owners
            harvest:job_owners:destroy: Destroy job owners
            harvest:job_post_locations:list: List job post locations
            harvest:job_post_locations:create: Create job post locations
            harvest:job_post_locations:destroy: Destroy job post locations
            harvest:job_posts:list: List job posts
            harvest:job_posts:update: Update job posts
            harvest:jobs:list: List jobs
            harvest:jobs:create: Create jobs
            harvest:jobs:update: Update jobs
            harvest:notes:list: List notes
            harvest:notes:create: Create notes
            harvest:offers:list: List offers
            harvest:offers:create: Create offers
            harvest:offers:update: Update offers
            harvest:offices:list: List offices
            harvest:offices:create: Create offices
            harvest:offices:update: Update offices
            harvest:openings:list: List openings
            harvest:openings:create: Create openings
            harvest:openings:destroy: Destroy openings
            harvest:openings:update: Update openings
            harvest:prospect_details:list: List prospect details
            harvest:prospect_pool_stages:list: List prospect pool stages
            harvest:prospect_pools:list: List prospect pools
            harvest:referrers:list: List referrers
            harvest:rejection_details:list: List rejection details
            harvest:rejection_details:update: Update rejection details
            harvest:rejection_reasons:list: List rejection reasons
            harvest:scorecard_candidate_attributes:list: List scorecard candidate attributes
            harvest:scorecard_candidate_attributes:create: Create scorecard candidate attributes
            harvest:scorecard_candidate_attributes:update: Update scorecard candidate attributes
            harvest:scorecard_question_answer_options:create: Create scorecard question answer options
            harvest:scorecard_question_answer_options:list: List scorecard question answer options
            harvest:scorecard_question_answers:list: List scorecard question answers
            harvest:scorecard_question_answers:create: Create scorecard question answers
            harvest:scorecard_question_answers:update: Update scorecard question answers
            harvest:scorecard_question_candidate_attributes:list: List scorecard question candidate attributes
            harvest:scorecard_question_options:list: List scorecard question options
            harvest:scorecard_questions:list: List scorecard questions
            harvest:scorecards:list: List scorecards
            harvest:scorecards:create: Create scorecards
            harvest:scorecards:update: Update scorecards
            harvest:sources:list: List sources
            harvest:tracking_links:list: List tracking links
            harvest:user_emails:list: List user emails
            harvest:user_emails:create: Create user emails
            harvest:user_job_permissions:list: List user job permissions
            harvest:user_job_permissions:create: Create user job permissions
            harvest:user_job_permissions:destroy: Destroy user job permissions
            harvest:user_roles:list: List user roles
            harvest:users:list: List users
            harvest:users:create: Create users
            harvest:users:update: Update users
            harvest:users:deactivate: Deactivate users
            harvest:users:activate: Activate users
            harvest:users:revoke_permissions: Revoke permissions users
            harvest:webhooks:create: Create webhooks
            harvest:webhooks:update: Update webhooks
            harvest:webhooks:destroy: Destroy webhooks
            harvest:webhooks:list: List webhooks
            auditlog:events:list: List audit log events
x-refined-from:
- greenhouse-harvest-v3-openapi.json
- greenhouse-harvest-v3-openapi.yml
x-readme:
  headers: []
x-readme-fauxas: true