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

# Crear una retención

`POST /retentions`

## Request

- Base URL: `https://api.alegra.com/api/v1`
- URL: `https://api.alegra.com/api/v1/retentions`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

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.dev/alegra/apis/configuraciones.md) - [All operations](https://skmtc.dev/alegra/apis/configuraciones/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/configuraciones/revisions/5a651ca3b942?raw)