Crear Carpeta Digital

POST

https://app.firmeasy.legal/api/v1/digital/carpeta

Crear Carpeta Digital

Este endpoint permite crear una nueva carpeta de organización específicamente para el módulo de Firma Digital. Es el paso inicial para estructurar y agrupar tus documentos antes de iniciar cualquier flujo de firma.

Autorización

Este recurso está protegido. Debes incluir tu token de acceso en el encabezado de la petición.

Parámetro	Tipo	Descripción	Límites
`Authorization`	string	Token de acceso (Bearer token).	Obligatorio
`Content-Type`	string	Especifica el formato de la petición.	application/json

Authorization

string

Token de acceso (Bearer token).

Límites:Obligatorio

Content-Type

string

Especifica el formato de la petición.

Límites:application/json

Parámetros de la Petición

Campos Obligatorios

Los campos marcados con un asterisco (*) son obligatorios y deben ser proporcionados en la solicitud. Los demás campos son opcionales.

Envía el nombre de la carpeta en el cuerpo (body) de tu petición POST en formato JSON.

Parámetro	Tipo	Descripción	Límites
`nombre`	string	Nombre identificativo que tendrá la nueva carpeta en la plataforma.	Obligatorio

nombre

string

Nombre identificativo que tendrá la nueva carpeta en la plataforma.

Límites:Obligatorio

Ejemplos de Implementación

cURL

curl -X POST [https://app.firmeasy.legal/api/v1/digital/carpeta](https://app.firmeasy.legal/api/v1/digital/carpeta) \
  -H "Authorization: Bearer TU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "nombre": "Carpeta Nueva Proveniente del API"
  }'

Node.js (Fetch)

const myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer TU_TOKEN_AQUI");
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "nombre": "Carpeta Nueva Proveniente del API"
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("[https://app.firmeasy.legal/api/v1/digital/carpeta](https://app.firmeasy.legal/api/v1/digital/carpeta)", requestOptions)
  .then((response) => response.json())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

Códigos de Estado

Código	Estado	Descripción
`200`	OK	Carpeta creada correctamente.
`400`	Bad Request	Fallo en la estructura del JSON o nombre inválido.
`401`	Unauthorized	Token ausente o inválido.
`500`	Server Error	Falla interna en los servidores.