Skip to main content
POST
Create a company express
Early access. Partner keys are issued on request: write to hello@melso.ai. See Partner API.
Melso confirms the company within a few business hours, with its name, NIF and deed. There is no incorporation to wait for: the company already exists. Its shares are transferred to the owner before a notary, and the owner can rename it later. 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
owner
object
required
activity
string
required

What the company will do, in a sentence.

external_id
string

Your own ID for this customer.

Maximum string length: 200

Response

The company, requested, with express true.

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