> ## Documentation Index
> Fetch the complete documentation index at: https://docs.melso.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Melso MCP: https://mcp.melso.ai/mcp (OAuth; one company per connection). Documentation-search MCP: https://docs.melso.ai/mcp; it does not act on customer accounts. Melso API: https://api.melso.ai/v1, invoicing only, with a company API key.
>
> Use the live tool list and respect company membership. Ask the person to approve the exact invoice or tax return version in the signed-in app. Melso's professionals prepare and file included returns after approval; an AI assistant does not file. A prepared file or an approval is not evidence of filing: only the AEAT's reference and receipt are. Keep credentials out of chat and logs.

# SL exprés por API — Create a company express

> Assigns your customer an S.L. that Melso already incorporated, from its pool of ready companies.

> [!NOTE]
>
> **Early access.** Partner keys are issued on request: write to [hello@melso.ai](mailto:hello@melso.ai). See [Partner API](https://docs.melso.ai/api/partner/overview.md).

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.


## OpenAPI

````yaml api/partner-openapi.yaml POST /partner/companies/express
openapi: 3.1.0
info:
  title: Melso Partner API
  version: 0.1.0-early-access
  summary: Open companies in Melso for your customers.
  description: |
    Early access. A partner key works across the companies you open for your
    customers. Melso issues partner keys on request: write to
    hello@melso.ai. Melso's professionals carry out each incorporation and
    registration.
  contact:
    name: Melso
    email: hello@melso.ai
    url: https://docs.melso.ai/api/partner/overview
servers:
  - url: https://api.melso.ai/v1
security:
  - partnerApiKey: []
tags:
  - name: Partner companies
    description: Companies you open in Melso for your customers.
paths:
  /partner/companies/express:
    post:
      tags:
        - Partner companies
      summary: Create a company express
      description: >
        Assigns your customer an S.L. that Melso already incorporated, from its
        pool of ready companies. 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.
      operationId: createPartnerCompanyExpress
      parameters:
        - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartnerCompanyExpressInput'
            example:
              external_id: cus_48215
              owner:
                name: Lucía Martín Pérez
                email: lucia@example.com
                tax_id: 00000000T
              activity: Consultoría de software
      responses:
        '202':
          description: The company, `requested`, with `express` `true`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerCompany'
              example:
                id: 2c4d6e8f-0a1b-4c3d-9e5f-6a7b8c9d0e1f
                status: requested
                setup: incorporate_sl
                express: true
                external_id: cus_48215
                legal_name: null
                tax_id: null
                created_at: '2026-11-21T10:05:43Z'
                ready_at: null
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '422':
          $ref: '#/components/responses/IdempotencyKeyReused'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  parameters:
    IdempotencyKey:
      name: Idempotency-Key
      in: header
      description: >-
        A unique key of yours, such as a UUID. A retry with the same key and
        body gets the first answer again.
      schema:
        type: string
        maxLength: 255
  schemas:
    PartnerCompanyExpressInput:
      type: object
      required:
        - owner
        - activity
      additionalProperties: false
      properties:
        external_id:
          type: string
          maxLength: 200
          description: Your own ID for this customer.
        owner:
          $ref: '#/components/schemas/Owner'
        activity:
          type: string
          description: What the company will do, in a sentence.
    PartnerCompany:
      type: object
      required:
        - id
        - status
        - setup
        - express
        - external_id
        - legal_name
        - tax_id
        - created_at
        - ready_at
      properties:
        id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - requested
            - in_progress
            - ready
            - cancelled
          description: >-
            `requested` when you create it, `in_progress` while Melso works on
            it, `ready` once it can invoice.
        setup:
          type: string
          enum:
            - incorporate_sl
            - register_autonomo
            - existing
        express:
          type: boolean
          description: '`true` for a company from Melso''s pool.'
        external_id:
          type:
            - string
            - 'null'
        legal_name:
          type:
            - string
            - 'null'
          description: Set once the company is `ready`.
        tax_id:
          type:
            - string
            - 'null'
          description: The company's NIF, set once it is `ready`.
        created_at:
          type: string
          format: date-time
        ready_at:
          type:
            - string
            - 'null'
          format: date-time
    Owner:
      type: object
      required:
        - name
        - email
      additionalProperties: false
      properties:
        name:
          type: string
          description: The owner's full name.
        email:
          type: string
          format: email
          description: Where Melso invites the owner to sign in.
        tax_id:
          type: string
          description: The owner's DNI or NIE.
        phone:
          type: string
    Error:
      type: object
      required:
        - error
        - code
        - request_id
      properties:
        error:
          type: string
          description: What went wrong
          for a person to read.: null
        code:
          type: string
          description: A stable code to branch on.
        request_id:
          type: string
  responses:
    BadRequest:
      description: The request is malformed or a field is invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: The partner key is missing, revoked or invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    IdempotencyKeyReused:
      description: This `Idempotency-Key` was sent with another request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: Too many requests. Wait `Retry-After` seconds.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    partnerApiKey:
      type: http
      scheme: bearer
      description: |
        A partner key, `mk_partner_…`, that Melso issues on request. Keep it on
        your servers.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.