POST
Crear un empleado
Scope:
team:employees.writehttps://api.holded.com/api/v2/employeesCrea un nuevo empleado en tu cuenta.
Cuerpo de la petición
object
namestringrequired
Nombre del empleado
last_namestringrequired
Apellidos del empleado
emailstring<email>required
Email principal del empleado
workplace_idstring | nulloptional
Identificador del centro de trabajo
phonestring | nulloptional
Número de teléfono
mobilestring | nulloptional
Número de móvil
date_of_birthstring | nulloptional
Fecha de nacimiento
genderstring | nulloptional
Género
main_languagestring | nulloptional
Código de idioma principal
nationalitystring | nulloptional
Código de nacionalidad
codestring | nulloptional
Código interno del empleado
social_security_numberstring | nulloptional
Número de seguridad social
ibanstring | nulloptional
IBAN bancario
reporting_tostring | nulloptional
ID del empleado responsable
team_ids[]string[] | nulloptional
IDs de los equipos a los que pertenece
Petición
python
import requests
url = "https://api.holded.com/api/v2/employees"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
payload = {
"name": "string",
"last_name": "string",
"email": "user@example.com",
"workplace_id": "string",
"phone": "string",
"mobile": "string",
"date_of_birth": "string",
"gender": "string",
"main_language": "string",
"nationality": "string",
"code": "string",
"social_security_number": "string",
"iban": "string",
"reporting_to": "string",
"team_ids": [
"string"
]
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())Respuestas
Respuesta
json
{
"id": "507f1f77bcf86cd799439011"
}Respuestas exitosas
201Empleado creadoapplication/jsonobject
idstring
Respuestas de error
400Solicitud incorrectaapplication/json401API key inválida o no proporcionadaapplication/json403Permisos insuficientesapplication/json409Ya existe un empleado con ese emailapplication/jsonobject
typestring
titlestring
statusinteger
detailstring
422Error de validaciónapplication/json429Límite de solicitudes excedidoapplication/json