Skip to content
Testsigma DOCS

Create a project

POST/projects

Base URL  https://test-management.testsigma.com/api/v1

Creates a new project with a name, description, and human-readable ID prefix.

Authenticate with your API key as a Bearer token in the Authorization header. Generate a key →
nameName of the project.
descriptionBrief description of the project.
human_id_prefixPrefix used for the project's human-readable identifier.
messageStatus message for the request; may be empty.
data.project.idUnique identifier of the created project.
data.project.created_atUnix timestamp of when the project was created.
data.project.updated_atUnix timestamp of the last update to the project.
data.project.nameName of the project.
data.project.descriptionDescription of the project.
data.project.human_id_prefixPrefix used for the project's human-readable identifier.
REQUEST
curl -X POST \
  'https://test-management.testsigma.com/api/v1/projects' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Health Care Project",
    "description": "Regression suite for the patient portal",
    "human_id_prefix": "HCP"
  }'
const response = await fetch('https://test-management.testsigma.com/api/v1/projects', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      "name": "Health Care Project",
      "description": "Regression suite for the patient portal",
      "human_id_prefix": "HCP"
  })
});
const data = await response.json();
import requests

response = requests.post(
  'https://test-management.testsigma.com/api/v1/projects',
  headers={
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  },
  json={
      "name": "Health Care Project",
      "description": "Regression suite for the patient portal",
      "human_id_prefix": "HCP"
  }
)
data = response.json()
RESPONSE200OK
{
  "message": "",
  "data": {
    "project": {
      "id": "c47ade67-0543-4582-a4a5-b7de447c94f5",
      "created_at": 1710675200,
      "updated_at": 1710675200,
      "name": "Health Care Project",
      "description": "Regression suite for the patient portal",
      "human_id_prefix": "HCP"
    }
  }
}