Saltar al contenido principal
POST

Crear un empleado

Scope:team:employees.write
https://api.holded.com/api/v2/employees

Crea 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/json
object
idstring

Respuestas de error

400Solicitud incorrectaapplication/json
401API key inválida o no proporcionadaapplication/json
403Permisos insuficientesapplication/json
409Ya existe un empleado con ese emailapplication/json
object
typestring
titlestring
statusinteger
detailstring
422Error de validaciónapplication/json
429Límite de solicitudes excedidoapplication/json