Skip to main content
POST
Add an employee
Live capability. Melso runs this in production today. Partner keys reach it once your partner account is enabled. See Availability.
name, start_date and details are live today. The structured identity and employment fields are preview: they are what affiliation, payroll runs and SEPE notifications use.

Authorizations

Authorization
string
header
required

Your partner secret key, mk_live_… for real companies or mk_test_… for test companies. Keep it on your servers. See Authentication.

Headers

Idempotency-Key
string

A unique key, such as a UUID, that makes a retried create safe. Reusing a key with a different body is refused.

Maximum string length: 255

Path Parameters

company_id
string<uuid>
required

The company's ID. Every company-scoped call works in exactly this company.

Body

application/json
name
string
required
Required string length: 1 - 200
start_date
string<date>
required
details
object

Free-form notes for Melso's team, such as the job and salary agreed.

external_id
string

Preview. Your ID for the employee.

tax_id
string

Preview. DNI or NIE.

social_security_number
string

Preview. The número de afiliación (NAF)

birth_date
string<date>

Preview.

employment
object

Preview. What the TGSS and the SEPE need about the job.

Response

The employee.

id
string<uuid>
required
name
string
required
start_date
string<date>
required
details
object
required
active
boolean
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
external_id
string | null

Preview.

tax_id
string | null

Preview.

social_security_number
string | null

Preview.

birth_date
string<date> | null

Preview.

employment
object

Preview. What the TGSS and the SEPE need about the job.