---
title: "Crea una organización"
method: POST
path: "/organizations"
tags: ["Configuración"]
---

# Crea una organización

`POST /organizations`

## Request

- Base URL: `https://payroll-calculator-api.alegra.com/v1`
- URL: `https://payroll-calculator-api.alegra.com/v1/organizations`
- Auth: HTTP bearer

Da de alta una organización a partir de un `id` de empresa. Inicializa plan free y numeraciones por defecto del país.

## Request body

- object
  - `id` string, required: ID de la empresa origen.
  - `origin` string: Origen del alta (ej. 'integration').

## Response `200`

Organización creada.

- object
  - `organization` Organization
    - `id` string
    - `name` string
    - `identification` string: NIT/RFC/RNC según país; 'NO_NIT' indica pendiente.
    - `dv` string: Dígito verificador (Colombia).
    - `version` 'colombia' | 'mexico' | 'republicaDominicana'
    - `governmentStatus` 'AUTHORIZED' | 'PENDING' | 'REJECTED'
    - `hasMandateSignature` boolean
    - `hasFirstEmployee` boolean
    - `firstEmissionDate` string, date-time, nullable
    - `testSet` object, nullable

## Other responses

- `400`: Validación fallida.
- `401`: Token ausente, expirado o inválido.
- `500`: Error interno del servidor.

---

[API](https://skmtc.dev/alegra/apis/alegra-payroll-api-configuraci-n-organizaci-n.md) - [All operations](https://skmtc.dev/alegra/apis/alegra-payroll-api-configuraci-n-organizaci-n/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/alegra-payroll-api-configuraci-n-organizaci-n/revisions/0c1e42bf85c9?raw)