# Recruitee

Recruitee is a collaborative hiring software that streamlines recruitment processes, enabling teams to source, interview, and hire candidates efficiently.

- **Category:** hr talent & recruitment
- **Auth:** API_KEY, OAUTH2
- **Composio Managed App Available?** No
- **Tools:** 25
- **Triggers:** 0
- **Slug:** `RECRUITEE`
- **Version:** 20260312_00

## Tools

### Create Candidate

**Slug:** `RECRUITEE_CREATE_CANDIDATE`

Tool to create a new candidate profile. Use after gathering all candidate details. Example: "Create a new candidate named Jane Doe with email jane.doe@example.com."

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Full name of the candidate. |
| `tags` | array | No | List of tags associated with the candidate. |
| `email` | string | No | Email address of the candidate |
| `phone` | string | No | Phone number of the candidate. |
| `photo` | string | No | URL to the candidate's photo |
| `offers` | array | No | List of offer IDs to associate with the candidate. |
| `resume` | string | No | URL to the candidate's resume |
| `source` | string | No | The source from which the candidate was obtained. |
| `cover_letter` | string | No | Cover letter text for the candidate. |
| `social_links` | array | No | List of social media profile links for the candidate. |
| `custom_fields` | object | No | Custom fields for the candidate as defined by the company. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Note

**Slug:** `RECRUITEE_CREATE_NOTE`

Creates a new note for a candidate in Recruitee. Notes can be used to record interview feedback, assessments, or any observations about the candidate. Use this when you need to add commentary or documentation to a candidate's profile.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `note` | object | Yes | The note object containing content and optional visibility. |
| `candidate_id` | string | Yes | Unique identifier of the candidate to attach the note to. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Offer

**Slug:** `RECRUITEE_CREATE_OFFER`

Creates a new job offer or talent pool in Recruitee. Required fields include title, location IDs, and description. Use Get Locations action to retrieve valid location IDs before creating an offer. The offer status can be set to draft, internal, published, closed, or archived.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `offer` | object | Yes | The offer object containing details for the new job offer. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Candidate

**Slug:** `RECRUITEE_DELETE_CANDIDATE`

Tool to delete a candidate profile. Use when you need to permanently remove a candidate from your Recruitee account. Returns no content on success.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `candidate_id` | integer | Yes | Unique identifier of the candidate to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Tag

**Slug:** `RECRUITEE_DELETE_TAG`

Permanently deletes a tag from Recruitee by its ID. This action requires appropriate API permissions to delete tags. Use this when you need to remove unused or obsolete tags. Note: Deleting a tag removes it from all associated candidates and offers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag_id` | integer | Yes | The unique numeric identifier of the tag to delete. Must be a positive integer. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Candidate

**Slug:** `RECRUITEE_GET_CANDIDATE`

Tool to retrieve detailed information about a specific candidate. Use when you need the candidate's full profile before proceeding.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company_id` | string | No | Company ID or subdomain. Can be either the numerical company ID or the company subdomain. If not provided, uses the subdomain from the connection. |
| `candidate_id` | integer | Yes | Unique identifier of the candidate to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Candidates

**Slug:** `RECRUITEE_GET_CANDIDATES`

Tool to retrieve a list of all candidates in the company. Use when you need to fetch or filter candidates before proceeding.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ids` | array | No | List of candidate IDs to retrieve. |
| `sort` | string ("by_date" | "by_last_message") | No | Sort by date or by last message. |
| `limit` | integer | No | Maximum number of candidates to return. |
| `query` | string | No | Search term to filter candidates by name or offer. |
| `offset` | integer | No | Number of candidates to skip before returning results (pagination offset). |
| `deleted` | boolean | No | If true, only deleted candidates are returned. |
| `offerId` | integer | No | Filter candidates by specific offer ID. |
| `qualified` | boolean | No | If true, only qualified candidates are returned. |
| `company_id` | string | No | Company ID or subdomain. Can be either the numerical company ID or the company subdomain. If not provided, uses the subdomain from the connection. |
| `createdAfter` | string | No | Return candidates created after this ISO 8601 timestamp. |
| `disqualified` | boolean | No | If true, only disqualified candidates are returned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Company ID

**Slug:** `RECRUITEE_GET_COMPANY_ID`

Tool to retrieve the company ID of the authenticated account. Use when you need to confirm your company identity before other operations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Company Offer Public

**Slug:** `RECRUITEE_GET_COMPANY_OFFER_PUBLIC`

Tool to retrieve a specific published job offer by ID or slug from the public Careers Site API. Use after you have the offer identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `identifier` | string | Yes | Offer ID or slug, e.g., '12345' or 'software-engineer'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Departments

**Slug:** `RECRUITEE_GET_DEPARTMENTS`

Tool to retrieve a list of company departments. Use when you need to reference or assign offers or candidates to departments.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Locations

**Slug:** `RECRUITEE_GET_LOCATIONS`

Tool to retrieve a list of company locations. Use when you need to see all location options before assigning them to offers.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Notes

**Slug:** `RECRUITEE_GET_NOTES`

Tool to retrieve a list of notes for a specific candidate. Use after confirming the candidate exists when you need to review their notes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of notes to return per page. |
| `offset` | integer | No | Number of notes to skip. |
| `candidate_id` | integer | Yes | Unique identifier of the candidate. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Offers

**Slug:** `RECRUITEE_GET_OFFERS`

Tool to retrieve a list of all job offers. Use after authentication to browse or paginate your company's complete set of offers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of offers to return (1-100). |
| `query` | string | No | Search term to filter job offers. |
| `offset` | integer | No | Number of offers to skip (for pagination). |
| `company_id` | string | No | Company ID or subdomain. Can be either the numerical company ID or the company subdomain. If not provided, uses the subdomain from the connection. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Pipeline Stages

**Slug:** `RECRUITEE_GET_PIPELINE_STAGES`

Tool to retrieve pipeline stages of a job offer. Use when you have the offer ID and need its stages to track candidate progression. Example: "Get pipeline stages for offer ID 456."

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `offer_id` | integer | Yes | ID of the job offer to retrieve pipeline stages for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tags

**Slug:** `RECRUITEE_GET_TAGS`

Retrieve all tags with optional filtering and pagination. Search by name, sort by name or usage count, and paginate through results.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number of results (minimum 1). |
| `query` | string | No | Search term to filter tags by name. |
| `sort_by` | string ("name" | "taggings_count") | No | Field to sort by: 'name' or 'taggings_count'. |
| `per_page` | integer | No | Number of tags per page (1-100). |
| `sort_order` | string ("asc" | "desc") | No | Sort order: 'asc' or 'desc'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List EEO Job Categories

**Slug:** `RECRUITEE_LIST_EEO_JOB_CATEGORIES`

Tool to retrieve available EEO (Equal Employment Opportunity) job categories. Use when you need to see standard EEO job classification options.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Invoices

**Slug:** `RECRUITEE_LIST_INVOICES`

Tool to list invoices for a company. Use to retrieve billing invoice records.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company_id` | string | No | Company ID or subdomain. Can be either the numerical company ID or the company subdomain. If not provided, uses the subdomain from the connection. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Localization Settings

**Slug:** `RECRUITEE_LIST_LOCALIZATION_SETTINGS`

Tool to retrieve localization settings including proposed time format and start day of the week. Use when you need to check regional or time display preferences.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Share Countries

**Slug:** `RECRUITEE_LIST_SHARE_COUNTRIES`

Tool to retrieve all countries with region codes and phone codes per locale. Use when you need comprehensive country reference data including internationalization details.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Share EEO Answers

**Slug:** `RECRUITEE_LIST_SHARE_EEO_ANSWERS`

Tool to retrieve available EEO (Equal Employment Opportunity) answers. Use when you need to see available answer options for EEO compliance questions.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Candidate

**Slug:** `RECRUITEE_UPDATE_CANDIDATE`

Updates an existing candidate's information in Recruitee. Use this to modify candidate details such as name, contact info, cover letter, tags, and social links. All fields except candidate_id are optional - only provide the fields you want to update. The API performs a partial update (PATCH), preserving any fields you don't specify.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Full name of the candidate. |
| `tags` | array | No | List of tags associated with the candidate. |
| `email` | string | No | Primary email address of the candidate. Note: The Recruitee API stores emails as an array, so this field may not update the candidate's email list as expected. |
| `phone` | string | No | Primary phone number of the candidate. Note: The Recruitee API stores phones as an array, so this field may not update the candidate's phone list as expected. |
| `photo` | string | No | URL to the candidate's photo. |
| `offers` | array | No | List of offer IDs to associate with the candidate. |
| `resume` | string | No | URL to the candidate's resume. |
| `source` | string | No | Source from which the candidate was obtained. Must be a valid source defined in the Recruitee system. Common values include 'manual', 'career_site', etc. Invalid sources will result in a 422 error. |
| `candidate_id` | integer | Yes | Unique identifier of the candidate to update. |
| `cover_letter` | string | No | Cover letter text for the candidate. |
| `social_links` | array | No | List of social media profile links for the candidate. |
| `custom_fields` | object | No | Custom fields for the candidate as defined by the company. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Note

**Slug:** `RECRUITEE_UPDATE_NOTE`

Tool to update an existing note for a candidate. Use when you need to modify note text or pin status after creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | string | No | Updated text content of the note. |
| `pinned` | boolean | No | True to pin the note, false to unpin. |
| `note_id` | integer | Yes | Unique identifier of the note to update. |
| `candidate_id` | integer | Yes | Unique identifier of the candidate. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Offer

**Slug:** `RECRUITEE_UPDATE_OFFER`

Updates an existing job offer or talent pool in Recruitee. Allows modification of offer details including title, description, requirements, status, locations, department assignment, work type (remote/hybrid/on-site), visibility settings, and application form field requirements. Only specified fields are updated; omitted fields remain unchanged. Requires the offer ID - use Get Offers or Get Offer actions to retrieve existing offer IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `kind` | string ("job" | "talent_pool") | No | Type of the offer: 'job' for standard job postings or 'talent_pool' for talent pools. |
| `title` | string | No | The title of the job offer. |
| `hybrid` | boolean | No | Display the job as hybrid (combination of on-site and remote) on the careers site. |
| `remote` | boolean | No | Display the job as fully remote on the careers site. |
| `status` | string ("draft" | "internal" | "published" | "closed" | "archived") | No | Current status of the offer. Options: 'draft' (not visible), 'internal' (visible to team), 'published' (public), 'closed' (no longer accepting applications), 'archived' (hidden from all views). |
| `on_site` | boolean | No | Display the job as on-site on the careers site. |
| `offer_id` | integer | Yes | The unique identifier of the offer to update. Required. |
| `options_cv` | string ("required" | "optional" | "off") | No | CV/resume upload field setting in application form. Options: 'required' (must upload), 'optional' (can upload), 'off' (field hidden). |
| `description` | string | No | Detailed description of the job offer. Supports HTML formatting. |
| `location_ids` | array | No | List of location IDs for the job offer. Use Get Locations action to retrieve valid IDs. |
| `requirements` | string | No | Job requirements and qualifications. Supports HTML formatting. |
| `department_id` | integer | No | Department ID to assign the offer to. Use Get Departments action to retrieve valid IDs. |
| `options_phone` | string ("required" | "optional" | "off") | No | Phone number field setting in application form. Options: 'required' (must provide), 'optional' (can provide), 'off' (field hidden). |
| `options_photo` | string ("required" | "optional" | "off") | No | Photo upload field setting in application form. Options: 'required' (must upload), 'optional' (can upload), 'off' (field hidden). |
| `locations_question` | string | No | Custom question text for the location picker in the application form. Only used when 'locations_question' is in visibility_options. |
| `visibility_options` | array | No | Job visibility and feature options. Include 'indeed' to post on Indeed, 'linkedin' for LinkedIn, 'social_share' for social media sharing, 'job_location' to show location, 'locations_question' to enable location picker in application form. |
| `options_cover_letter` | string ("required" | "optional" | "off") | No | Cover letter field setting in application form. Options: 'required' (must provide), 'optional' (can provide), 'off' (field hidden). |
| `locations_question_type` | string ("single_choice" | "multiple_choice") | No | Type of location selection in application form: 'single_choice' allows one location, 'multiple_choice' allows multiple. |
| `locations_question_required` | boolean | No | Whether applicants must answer the location question to submit their application. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |