Create project
curl --request POST \
--url https://api.filexpress.app/api/external/v1/projects \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"name": "Remodelación oficinas Grupo ABC",
"customer_id": "3b8e2f10-7c4d-4a9e-b1f2-5d6c7e8f9a01",
"branch_id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
"start_date": "2026-09-01",
"end_date": "2026-12-15",
"budget": 25000,
"status": "in_progress",
"description": "Obra civil y mobiliario"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Remodelación oficinas Grupo ABC',
customer_id: '3b8e2f10-7c4d-4a9e-b1f2-5d6c7e8f9a01',
branch_id: '9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11',
start_date: '2026-09-01',
end_date: '2026-12-15',
budget: 25000,
status: 'in_progress',
description: 'Obra civil y mobiliario'
})
};
fetch('https://api.filexpress.app/api/external/v1/projects', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.filexpress.app/api/external/v1/projects"
payload = {
"name": "Remodelación oficinas Grupo ABC",
"customer_id": "3b8e2f10-7c4d-4a9e-b1f2-5d6c7e8f9a01",
"branch_id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
"start_date": "2026-09-01",
"end_date": "2026-12-15",
"budget": 25000,
"status": "in_progress",
"description": "Obra civil y mobiliario"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.filexpress.app/api/external/v1/projects",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Remodelación oficinas Grupo ABC',
'customer_id' => '3b8e2f10-7c4d-4a9e-b1f2-5d6c7e8f9a01',
'branch_id' => '9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11',
'start_date' => '2026-09-01',
'end_date' => '2026-12-15',
'budget' => 25000,
'status' => 'in_progress',
'description' => 'Obra civil y mobiliario'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"status": true,
"data": {
"id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
"name": "Remodelación oficinas Grupo ABC",
"status": "in_progress",
"customer": {
"id": "3b8e2f10-7c4d-4a9e-b1f2-5d6c7e8f9a01",
"name": "Grupo ABC S.A. de C.V."
},
"branch_id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
"start_date": "2026-09-01",
"end_date": "2026-12-15",
"budget": 25000,
"description": "Obra civil y mobiliario",
"quotation_id": null,
"created_at": "2026-08-28T11:00:00-06:00"
}
}
Create project
Creates a project. The customer and branch must belong to the business.
Required permission: projects.write
POST
/
projects
Create project
curl --request POST \
--url https://api.filexpress.app/api/external/v1/projects \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"name": "Remodelación oficinas Grupo ABC",
"customer_id": "3b8e2f10-7c4d-4a9e-b1f2-5d6c7e8f9a01",
"branch_id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
"start_date": "2026-09-01",
"end_date": "2026-12-15",
"budget": 25000,
"status": "in_progress",
"description": "Obra civil y mobiliario"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Remodelación oficinas Grupo ABC',
customer_id: '3b8e2f10-7c4d-4a9e-b1f2-5d6c7e8f9a01',
branch_id: '9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11',
start_date: '2026-09-01',
end_date: '2026-12-15',
budget: 25000,
status: 'in_progress',
description: 'Obra civil y mobiliario'
})
};
fetch('https://api.filexpress.app/api/external/v1/projects', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.filexpress.app/api/external/v1/projects"
payload = {
"name": "Remodelación oficinas Grupo ABC",
"customer_id": "3b8e2f10-7c4d-4a9e-b1f2-5d6c7e8f9a01",
"branch_id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
"start_date": "2026-09-01",
"end_date": "2026-12-15",
"budget": 25000,
"status": "in_progress",
"description": "Obra civil y mobiliario"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.filexpress.app/api/external/v1/projects",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Remodelación oficinas Grupo ABC',
'customer_id' => '3b8e2f10-7c4d-4a9e-b1f2-5d6c7e8f9a01',
'branch_id' => '9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11',
'start_date' => '2026-09-01',
'end_date' => '2026-12-15',
'budget' => 25000,
'status' => 'in_progress',
'description' => 'Obra civil y mobiliario'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"status": true,
"data": {
"id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
"name": "Remodelación oficinas Grupo ABC",
"status": "in_progress",
"customer": {
"id": "3b8e2f10-7c4d-4a9e-b1f2-5d6c7e8f9a01",
"name": "Grupo ABC S.A. de C.V."
},
"branch_id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
"start_date": "2026-09-01",
"end_date": "2026-12-15",
"budget": 25000,
"description": "Obra civil y mobiliario",
"quotation_id": null,
"created_at": "2026-08-28T11:00:00-06:00"
}
}
Authorizations
Integration API Key (Integrations → New Integration).
Headers
Optional. Unique key per operation (max. 100 characters, valid for 24 h per integration). A retry with the same key and the same body returns the original response (header Idempotent-Replayed: true) without repeating the operation; with a different body, or while the first is still in progress, it returns 409.
Maximum string length:
100Body
application/json
Maximum string length:
255Customer of the business.
Status.
Available options:
planned, in_progress, completed, on_hold, cancelled Required range:
x >= 0Maximum string length:
2000