---
title: "Create SoundFile"
method: POST
path: "/soundfiles"
tags: ["SoundFiles", "soundfiles"]
---

# Create SoundFile

`POST /soundfiles`

## Request

- Base URL: `https://api.fonestorm.com/v2`
- URL: `https://api.fonestorm.com/v2/soundfiles`
- Auth: API key in header `token`

Add a new SoundFile to an account.

## Request body

- object
  - `label` string, required: Name/Label for SoundFile
  - `file` string: SoundFile or URL
  - `tts` string: Text to speech string
  - `tts_volume` string: Text to speech volume
  - `expires_at` string: Expiration date

## Response `201`

Created

- object
  - `soundfile` SoundFile
    - `id` string: SoundFile ID
    - `label` string: Name/Label for SoundFile
    - `soundfile` string: SoundFile name
    - `recording_id` string: Recording ID
    - `tts` string: Text to speech string
    - `tts_volume` string: Text to speech volume

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `default`: Error

---

[API](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail.md) · [All operations](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail/llms.txt) · [OpenAPI document](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail/revisions/9738d9b806d4?raw)