API

Version 3 HTTP reference for Talento. Authenticate with a Bearer token and call the company's subdomain.

This is the version 3 API. Versions 1 and 2 are deprecated and should not be used.

Authentication

You need two values from an administrator: the company subdomain and a personal API token. Send both on every request. The token belongs to an active employee; the call runs with that person's permissions inside that company.

Replace hr and YOUR_TOKEN with the real subdomain and token. Never put the token in the URL.

curl https://hr.talentohq.com/api/v3/employees/9ae9fe31-da27-434e-92f3-b8f4480b17a8 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"

Create, rotate, and revoke tokens in API access and integrations.

Warning

Treat an API token like a password. Store it in the integration's secrets manager and send it only over HTTPS.

Choose a resource below for paths, parameters, and example payloads.

For administrators

Employees

List, create, show, and update employees in the company.
Expenses

List, create, show, update, and delete expenses in the company.
Clock-ins

List, create, and delete clock-ins for an employee.
Job categories

List, create, show, update, and delete job categories in the company.
Working categories

List, create, show, update, and delete working categories in the company.
Absence categories

List, create, show, update, and delete absence categories in the company.
Contract categories

List, create, show, update, and delete contract categories in the company.
Skill categories

List, create, show, update, and delete skill categories in the company.
Skills

List, create, show, update, and delete skills in the company.
Employee skills

List, create, show, update, and delete employee skills for a skill.
Candidate skills

List, create, show, update, and delete candidate skills for a skill.
Account

Show the current company account.
- Show your account
Offices

List, create, show, and update offices in the company.
Teams

List, create, show, and update teams in the company.
Absences

List, create, show, update, and delete absences in the company.
Companies

List, create, show, update, and delete companies in the account.
Contracts

List, create, show, update, and delete contracts nested under an employee.
Candidates

List, create, show, update, and delete candidates in the company.
Resources

List, create, show, update, and delete resources in the company.
Assignment categories

List and show assignment categories in the company.
- List all assignment categories
- Show an assignment category
Assignments

List, create, show, update, and delete CRM assignments.
Closing factors

List and show closing factors in the company.
- List all closing factors
- Show a closing factor
Contacts

List, create, show, update, and delete CRM contacts.
Contract end reasons

List, create, show, update, and delete contract end reasons in the company.
Custom field definitions

List, create, show, update, and delete CRM custom field definitions.
Customer categories

List and show customer categories in the company.
- List all customer categories
- Show a customer category
Customer stage categories

List and show customer stage categories in the company.
- List all customer stage categories
- Show a customer stage category
Customers

List, create, show, update, and delete customers, and change customer stage.
Lead sources

List and show lead sources in the company.
- List all lead sources
- Show a lead source
Leads

List, create, show, update, and delete leads, record custom field observations, and run qualification, disqualification, and conversion.
Opportunities

List, create, show, update, and delete opportunities, change stage, and close or reopen them.
Opportunity stages

List and show opportunity stages in the company.
- List all opportunity stages
- Show an opportunity stage
Provider categories

List and show provider categories in the company.
- List all provider categories
- Show a provider category
Providers

List, create, show, update, and delete providers.