Create Digital Folder

POST

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

Create Digital Folder

This endpoint allows you to create a new organization folder specifically for the Digital Signature module. It is the initial step to structure and group your documents before starting any signature flow.

Authorization

This resource is protected. You must include your access token in the request header.

Parameter	Type	Description	Limits
`Authorization`	string	Access token (Bearer token).	Obligatorio
`Content-Type`	string	Specifies the format of the request.	application/json

Authorization

string

Access token (Bearer token).

Limits:Obligatorio

Content-Type

string

Specifies the format of the request.

Limits:application/json

Request Parameters

Required Fields

Fields marked with an asterisk (*) are required and must be provided in the request. Other fields are optional.

Send the folder name in the body of your POST request in JSON format.

Parameter	Type	Description	Limits
`nombre`	string	Identifying name that the new folder will have on the platform.	Obligatorio

nombre

string

Identifying name that the new folder will have on the platform.

Limits:Obligatorio

Implementation Examples

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));

Status Codes

Code	Status	Description
`200`	OK	Folder created successfully.
`400`	Bad Request	JSON structure failure or invalid name.
`401`	Unauthorized	Missing or invalid token.
`500`	Server Error	Internal server failure.