---
title: "Create a voice"
method: POST
path: "/v1/tones"
tags: ["Voices"]
---

# Create a voice

`POST /v1/tones`

Create a voice for use in personalizing AI outputs

## Request body

- CreateToneDto
  - `name` string, required — The friendly name of the voice.
  - `value` string, required — The voice's description
  - `metadata` object — An optional set of key-value pairs to attach any data you wish to the voice, in a structured format. You can specify up to 10 keys, with key names up to 40 characters long and values up to 500 characters long.
  - `settings` ToneSettingsDto
    - `appVisibility` 'visible' | 'hidden' — Whether the brand is available in the Jasper app. Provides a way to omit voices created from the API, from being available in the Jasper app experience. One of "visible" or "hidden". Defaults to "visible".

## Response `201`

Created. The new voice was added successfully.

- GetToneResponseDto
  - `requestId` string
  - `resource` string
  - `data` ToneDto
    - `name` string, required — The friendly name of the voice.
    - `value` string, required — The voice's description
    - `metadata` object — An optional set of key-value pairs to attach any data you wish to the voice, in a structured format. You can specify up to 10 keys, with key names up to 40 characters long and values up to 500 characters long.
    - `settings` ToneSettingsDto
      - `appVisibility` 'visible' | 'hidden' — Whether the brand is available in the Jasper app. Provides a way to omit voices created from the API, from being available in the Jasper app experience. One of "visible" or "hidden". Defaults to "visible".
    - `id` string
    - `createdAt` string
    - `updatedAt` string

## Other responses

- `400` — Bad request. May be missing required fields or may have badly formatted inputs or options.
- `500` — Internal server error. Unable to create the voice.

---

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