Skip to main content
POST
Create a company
Preview. A contract we are building with design partners. It is not callable yet, and fields can still change. See Availability.
The owner is the person who approves invoices and returns. Send setup_request when the company is not registered yet: Melso’s professionals register the autónomo (036 or 037 and RETA) or incorporate the company as a case.

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

Body

application/json
kind
enum<string>
required

freelancer for an autónomo, company for an empresa.

Available options:
freelancer,
company
name
string
required
owner
object
required

The person who approves the company's invoices and returns.

external_id
string
fiscal_profile
object
setup_request
enum<string>
default:none

Ask Melso's professionals to register the autónomo or incorporate the company.

Available options:
none,
register_autonomo,
incorporate_sl
services
enum<string>[]
Available options:
invoicing,
bookkeeping,
tax_returns,
payroll

Response

The company. missing lists what its fiscal profile still needs.

id
string<uuid>
required
name
string
required
kind
enum<string>
required

freelancer for an autónomo, company for an empresa.

Available options:
freelancer,
company
onboarded
boolean
required

Whether the company's setup is finished.

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

Preview. Your ID for the company.

missing
string[]

Preview. What the fiscal profile still needs, as in tax_missing.

updated_at
string<date-time>