---
title: "Endpoint para crear un vendedor"
method: POST
path: "/sellers"
tags: ["Crear un vendedor"]
---

# Endpoint para crear un vendedor

`POST /sellers`

## Request

- Base URL: `https://api.alegra.com/api/v1`
- URL: `https://api.alegra.com/api/v1/sellers`
- Auth: HTTP basic

Este endpoint permite crear vendedores

## Request body

- Seller: Vendedor
  - `id` string: Identificador único que representa un vendedor específico. La aplicación lo asigna automáticamente.
  - `name` string, required: Nombre del vendedor.
  - `identification` string: Número de identificación del vendedor.
  - `observations` string: Observaciones del vendedor.
  - `status` 'active' | 'inactive': Estado del vendedor. Las opciones posibles son active => El vendedor se encuentra activo. inactive => El vendedor se encuentra inactivo.

## Response `201`

Operación exitosa

- Seller: Vendedor
  - `id` string: Identificador único que representa un vendedor específico. La aplicación lo asigna automáticamente.
  - `name` string, required: Nombre del vendedor.
  - `identification` string: Número de identificación del vendedor.
  - `observations` string: Observaciones del vendedor.
  - `status` 'active' | 'inactive': Estado del vendedor. Las opciones posibles son active => El vendedor se encuentra activo. inactive => El vendedor se encuentra inactivo.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/alegra/apis/vendedores.md) - [All operations](https://skmtc.dev/alegra/apis/vendedores/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/vendedores/revisions/67d97eaed266?raw)