---
title: "Crear una retención"
method: POST
path: "/retentions"
tags: ["Retenciones"]
---

# Crear una retención

`POST /retentions`

Endpoint que permite crear una retención en la cuenta de Alegra.

## Request body

- object
  - `name` string
  - `calculatedBy` 'percentage' | 'fixedAmount'
  - `percentage` number
  - `description` string
  - `type` string

## Response `200`

Retorna información de una retención

- object
  - `id` string — ID de la retención
  - `idRetentionReference` string — ID de referencia de la retención
  - `name` string — Nombre de la retención
  - `calculatedBy` 'percentage' | 'fixedAmount' — Método de cálculo
  - `percentage` number — Porcentaje de la retención
  - `description` string — Descripción de la retención
  - `type` string — Tipo de retención
  - `status` 'active' | 'inactive' — Estado de la retención

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref

---

[API](https://skmtc.net/alegra/apis/ingresos.md) · [All operations](https://skmtc.net/alegra/apis/ingresos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/ingresos/revisions/cd52d3f68f1b/schema)