---
title: "Add sound via text-to-speech"
method: POST
path: "/campaigns/sounds/tts"
tags: ["campaigns"]
---

# Add sound via text-to-speech

`POST /campaigns/sounds/tts`

Use this API to create a sound file via a supplied string of text. Add a text in the TextToSpeech.message field, and pick a voice in the TextToSpeech.voice field. Available voices are: MALE1, FEMALE1, FEMALE2, SPANISH1, FRENCHCANADIAN1

## Query parameters

- `fields` string

## Request body

- TextToSpeech — Request object is used to create a sound from provided text using text to speech engine
  - `voice` 'MALE1' | 'FEMALE1' | 'FEMALE2' | 'SPANISH1' | 'FRENCHCANADIAN1' — A voice to be used. Available values: MALE1, FEMALE1 , FEMALE2, SPANISH1, FRENCHCANADIAN1
  - `message` string — A text to be turned into sound

## Response `200`

successful operation

- CampaignSound — Represents a sound recording from account's sound library which can be used in different API operations
  - `id` integer — An id of a sound file
  - `name` string — A name of a sound file
  - `created` integer — The time when the given resource was created, formatted in unix time milliseconds (read only). Example: 1473781817000 for Sat, 05 Jan 1985 14:03:37 GMT
  - `lengthInSeconds` integer — Length of a sound in seconds
  - `status` 'UPLOAD' | 'RECORDING' | 'ACTIVE' | 'ACTIVE_SYSTEM' | 'FAILED' | 'ARCHIVED' | 'SCRUBBED' — A current status of a sound, available values: UPLOAD - uploading is in progress, RECORDING - recording of sound is in progress, ACTIVE - sound is ready, FAILED, ARCHIVED - sound was archived, SCRUBBED - sound was scrubbed
  - `duplicate` boolean — True if the same sound file exists in a sound library of account

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/callfire/apis/callfire-api-documentation.md) · [All operations](https://skmtc.dev/callfire/apis/callfire-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/callfire/callfire-api-documentation/revisions/9f6fb501bc03/schema)