Skip to main content
POST
Early access. Partner keys are issued on request: write to hello@melso.ai. See Partner API.
Melso’s professionals do the registration or the incorporation, and the company becomes ready when it is done. The owner gets an email to sign in to Melso and approve what needs a person. Send an Idempotency-Key to retry safely.

Authorizations

Authorization
string
header
required

A partner key, mk_partner_…, that Melso issues on request. Keep it on your servers.

Headers

Idempotency-Key
string

A unique key of yours, such as a UUID. A retry with the same key and body gets the first answer again.

Maximum string length: 255

Body

application/json
setup
enum<string>
required

incorporate_sl incorporates a new S.L.; register_autonomo registers an autónomo with the AEAT and the Seguridad Social; existing brings a company or autónomo that already exists.

Available options:
incorporate_sl,
register_autonomo,
existing
owner
object
required
external_id
string

Your own ID for this customer.

Maximum string length: 200
details
object

What Melso's professionals need. For an S.L.: names (up to five, in order of preference), activity and capital. For an autónomo: activity and start_date. For an existing company: its tax_id.

Response

The company, requested. Follow it with Get a company.

id
string<uuid>
required
status
enum<string>
required

requested when you create it, in_progress while Melso works on it, ready once it can invoice.

Available options:
requested,
in_progress,
ready,
cancelled
setup
enum<string>
required
Available options:
incorporate_sl,
register_autonomo,
existing
express
boolean
required

true for a company from Melso's pool.

external_id
string | null
required

Set once the company is ready.

tax_id
string | null
required

The company's NIF, set once it is ready.

created_at
string<date-time>
required
ready_at
string<date-time> | null
required