Recruitee

Learn how to use Recruitee with Composio

Overview

SLUG

RECRUITEE

Description

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

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
string
bearer_token
string
subdomain
stringRequired
subdomain
stringRequired
generic_api_key
stringRequired

Tools

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."

Action Parameters

cover_letter
string
custom_fields
object
email
name
stringRequired
offers
array
phone
string
photo
resume
social_links
array
source
string
tags
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: RECRUITEE_CREATE_NOTE

Tool to create a new note for a candidate. use after confirming this detail.

Action Parameters

candidate_id
stringRequired
note
objectRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: RECRUITEE_CREATE_OFFER

Tool to create a new job offer. use after confirming all offer details and ready to publish.

Action Parameters

offer
objectRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

candidate_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: RECRUITEE_DELETE_TAG

Tool to delete a tag. use when you need to permanently remove a tag from recruitee. use after confirming the tag is not in use.

Action Parameters

tag_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: RECRUITEE_GET_CANDIDATE

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

Action Parameters

candidate_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

createdAfter
deleted
boolean
disqualified
boolean
ids
array
limit
integer
offerId
integer
offset
integer
qualified
boolean
query
string
sort
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: RECRUITEE_GET_COMPANY_OFFERS_PUBLIC

Tool to get a list of published company jobs from the careers site api. use when you need to list all current published offers.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

identifier
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

candidate_id
integerRequired
limit
integer
offset
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: RECRUITEE_GET_OFFER

Tool to retrieve detailed information about a specific job offer. use when you have the offer id and need its full metadata.

Action Parameters

offer_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

limit
integer
offset
integer
query
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

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."

Action Parameters

offer_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: RECRUITEE_GET_TAGS

Tool to retrieve a list of all tags. use after authenticating to fetch or search tags by name or usage count.

Action Parameters

page
integer
per_page
integer
query
string
sort_by
string
sort_order
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: RECRUITEE_UPDATE_CANDIDATE

Tool to update information for an existing candidate. use when you need to modify a candidate's profile after retrieval.

Action Parameters

candidate_id
integerRequired
cover_letter
string
custom_fields
object
email
name
string
offers
array
phone
string
photo
resume
social_links
array
source
string
tags
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

body
string
candidate_id
integerRequired
note_id
integerRequired
pinned
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: RECRUITEE_UPDATE_OFFER

Tool to update information for an existing job offer. use when you need to modify an offer's details after retrieval.

Action Parameters

offer_id
integerRequired
options_cover_letter
string
options_cv
string
options_phone
string
options_photo
string

Action Response

data
objectRequired
error
string
successful
booleanRequired