---
title: "Create project"
method: POST
path: "/projects"
tags: ["Projects"]
---

# Create project

`POST /projects`

Creates a project in your organization.

## Request body

- RequestBodyProjectCreate
  - `name` string, required — The project name
  - `language` object, required
    - `code` string — The default language of the project (ISO 639-1 code with optional region, e.g., en_GB)
  - `title` object
    - `enabled` boolean — When true, include content titles in generated audio (default is true)
    - `voice` object
      - `id` integer — The title voice id
  - `summary` object
    - `enabled` boolean — When true, include summary audio (default is false)
    - `voice` object
      - `id` integer — The summary voice id
  - `body` object
    - `enabled` boolean — When true, include body text in generated audio (default is true)
    - `voice` object
      - `id` integer — The body voice id
  - `background_track` object, nullable
    - `enabled` boolean
    - `track` object
      - `id` integer — The track id
  - `auto_publish_enabled` boolean — When true, automatically distribute content once generated (default is true)
  - `auto_video_publish_enabled` boolean — When true, automatically distribute video content once generated (default is true)
  - `avatar_url` string, uri — The project's avatar URL
  - `pause_after_title_segments_seconds` number
  - `pause_after_segments_seconds` number
  - `time_zone` string — The project time zone (IANA time zone name)
  - `environment` 'production' | 'staging', nullable

## Response `200`

successful

- ProjectModel
  - `id` integer — Unique identifier for the object
  - `name` string — The project name
  - `language` string — The default language of the project (ISO 639-1 code with optional region, e.g., en_GB)
  - `language_data` object — Additional language metadata for the project
  - `environment` 'production' | 'staging', nullable
  - `logo_color` string, nullable
  - `content_total_count` integer
  - `content_updated` string, date-time, nullable
  - `title` object
    - `enabled` boolean — When true, include content titles in generated audio (default is true)
    - `voice` object, nullable
      - `id` integer — The title voice id
      - `name` string — The title voice name
      - `speaking_rate` integer — The speaking rate of the voice
      - `multilingual_mode` boolean
      - `expressiveness` number, nullable
      - `use_speaker_boost` boolean, nullable
      - `similarity_boost` number, nullable
      - `style` number, nullable
  - `summary` object, nullable
    - `enabled` boolean — When true, include summary audio (default is false)
    - `voice` object, nullable
      - `id` integer — The summary voice id
      - `name` string — The summary voice name
      - `speaking_rate` integer — The speaking rate of the voice
      - `multilingual_mode` boolean
      - `expressiveness` number, nullable
      - `use_speaker_boost` boolean, nullable
      - `similarity_boost` number, nullable
      - `style` number, nullable
  - `body` object
    - `enabled` boolean — When true, include body text in generated audio (default is true)
    - `voice` object, nullable
      - `id` integer — The body voice id
      - `name` string — The body voice name
      - `speaking_rate` integer — The speaking rate of the voice
      - `multilingual_mode` boolean
      - `expressiveness` number, nullable
      - `use_speaker_boost` boolean, nullable
      - `similarity_boost` number, nullable
      - `style` number, nullable
  - `background_track` object, nullable
    - `enabled` boolean
    - `track` object, nullable
      - `id` integer
      - `name` string
      - `custom` boolean
      - `volume` integer
      - `url` string, uri
  - `auto_publish_enabled` boolean — When true, automatically distribute content once generated (default is true)
  - `auto_video_publish_enabled` boolean — When true, automatically distribute video content once generated (default is true)
  - `time_zone` string — The project time zone (IANA time zone name)
  - `avatar_url` string, uri, nullable — The project's avatar URL
  - `pause_after_title_segments_seconds` number
  - `pause_after_segments_seconds` number
  - `created` string, date-time — Time at which the object was created (ISO 8601)
  - `updated` string, date-time — Time at which the object was updated (ISO 8601)

---

[API](https://skmtc.net/beyondwords/apis/beyondwords-rest-api.md) · [All operations](https://skmtc.net/beyondwords/apis/beyondwords-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/beyondwords/beyondwords-rest-api/revisions/8c4bfe3e2ebd/schema)