> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dubformer.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Project

> Create a new project with general project information

## Request Body

<ParamField body="name" type="string" required>
  Name of the project.
</ParamField>

<ParamField body="managerEmail" type="string">
  Email of the project manager. If not provided, the API key user will be used as the manager.
</ParamField>

<ParamField body="translationsGlossaryId" type="string">
  Optional ID of a translation glossary to be used for this project.
</ParamField>

<ParamField body="voicesGlossaryId" type="string">
  Optional ID of a voices glossary to be used for this project.
</ParamField>

<ParamField body="remark" type="string">
  Optional remarks for the project.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Unique project identifier.
</ResponseField>

<ResponseField name="name" type="string">
  Name of the project.
</ResponseField>

<ResponseField name="status" type="string">
  Current status of the project.
</ResponseField>

<ResponseField name="translationGlossary" type="string | null">
  ID of the translation glossary, if any.
</ResponseField>

<ResponseField name="voicesGlossary" type="string | null">
  ID of the voices glossary, if any.
</ResponseField>

<ResponseField name="remark" type="string | null">
  Project remarks, if any.
</ResponseField>

<ResponseField name="clientName" type="string | null">
  Client name, if specified.
</ResponseField>

<ResponseField name="projectUrl" type="string">
  URL to access the project in the web app.
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp when the project was created.
</ResponseField>

<ResponseField name="updatedAt" type="string">
  ISO 8601 timestamp when the project was last updated.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST \
    https://studio.dubformer.ai/api/v1/projects/create \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d '{
      "name": "Marketing Campaign 2023",
      "managerEmail": "manager@company.com",
      "translationsGlossaryId": "gloss_5f83a14b2ec1b",
      "voicesGlossaryId": "voices_7c92e3a1f56d8"
    }'
  ```

  ```typescript TypeScript theme={null}
  import axios from 'axios';

  const response = await axios.post(
    'https://studio.dubformer.ai/api/v1/projects/create',
    {
      name: "Marketing Campaign 2023",
      managerEmail: "manager@company.com",
      translationsGlossaryId: "gloss_5f83a14b2ec1b",
      voicesGlossaryId: "voices_7c92e3a1f56d8"
    },
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
      }
    }
  );

  console.log(response.data);
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "proj_5f83a14b2ec1b",
    "name": "Marketing Campaign 2023",
    "status": "new",
    "translationGlossary": "gloss_5f83a14b2ec1b",
    "voicesGlossary": "voices_7c92e3a1f56d8",
    "remark": "Created via Dubformer Studio API",
    "clientName": null,
    "projectUrl": "https://studio.dubformer.ai/projects/proj_5f83a14b2ec1b",
    "createdAt": "2023-12-01T10:00:00.000Z",
    "updatedAt": "2023-12-01T10:00:00.000Z"
  }
  ```
</ResponseExample>

## Notes

<Note>
  This endpoint creates a project with basic information only. Videos can be added to the project using separate video management endpoints.
</Note>

<Note>
  The `managerEmail` must be a user from the same company as the API key owner. If not provided, the API key owner becomes the project manager.
</Note>

<Note>
  Translation and voices glossaries are optional but must exist and be accessible to your organization if provided.
</Note>