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

# Zapier

> Integrate Typecast TTS into your Zapier workflows without coding.

<Info>
  [Zapier](https://zapier.com/) is the most popular workflow automation platform. With the Typecast integration, you can convert text to speech automatically — no coding required!
</Info>

## What You Can Do

With the Typecast Zapier integration, you can:

* **Generate voiceovers** from any text automatically
* **Choose from 500+ voices** with different genders, ages, and styles
* **Apply emotions** (happy, sad, angry, whisper, and more)
* **Use Smart Emotion** for context-aware voice synthesis (ssfm-v30)
* **Recommend voices** from a text description, then fetch voice details before synthesis when needed
* **Connect to other apps** — send audio via email, save to cloud storage, post to Slack, etc.

***

## Prerequisites

Before you start, make sure you have:

1. **Zapier account** — [Sign up here](https://zapier.com/sign-up) if you don't have one
2. **Typecast API Key** — [Get yours here](https://typecast.ai/developers/api/)

***

## Installation

### Step 1: Connect Your Typecast Account

When you first use Typecast in a Zap:

1. You'll be prompted to connect your Typecast account
2. Enter your **Typecast API Key**
3. Click **Yes, Continue**

<Tip>
  You can get your API key from the [Typecast API Console](https://typecast.ai/developers/api/).
</Tip>

***

## Quick Start: Your First Voice Generation

Let's create a simple Zap that generates speech every hour!

### Step 1: Create a New Zap

1. Go to [Zapier Dashboard](https://zapier.com/app/assets/zaps)
2. Click **+ Create** → **New Zap**

<Frame caption="Zapier Zaps dashboard">
  <img src="https://mintcdn.com/neosapienceinc/Z2SKC4k1AnG1xbkd/images/zapier-zaps-dashboard.png?fit=max&auto=format&n=Z2SKC4k1AnG1xbkd&q=85&s=16761af31df4b2bf00ba1e014aa67869" alt="Zapier Zaps dashboard showing the Create button" width="1280" height="800" data-path="images/zapier-zaps-dashboard.png" />
</Frame>

### Step 2: Set Up the Trigger

For this example, we'll use a Schedule trigger:

1. Click on the **Trigger** step
2. Search for **Schedule** and select it
3. Choose **Every Hour** as the event
4. Click **Continue** and **Test trigger**

<Frame>
  <img src="https://mintcdn.com/neosapienceinc/hrSZOoWI1sT1VQOl/images/image-7.png?fit=max&auto=format&n=hrSZOoWI1sT1VQOl&q=85&s=32f34533552d4fa4cf5f200b4c58e5a7" alt="Image" width="2874" height="1454" data-path="images/image-7.png" />
</Frame>

### Step 3: Add Typecast Action

1. Click on the **Action** step
2. Search for **Typecast**
3. Select **Typecast (2.0.0)**

<Frame>
  <img src="https://mintcdn.com/neosapienceinc/hrSZOoWI1sT1VQOl/images/image-8.png?fit=max&auto=format&n=hrSZOoWI1sT1VQOl&q=85&s=4ba46bfdfd45242edc8daf01fe6c0904" alt="Image" width="2875" height="1456" data-path="images/image-8.png" />
</Frame>

4. Choose **Create Speech From Text** as the event

<Frame>
  <img src="https://mintcdn.com/neosapienceinc/hrSZOoWI1sT1VQOl/images/image-9.png?fit=max&auto=format&n=hrSZOoWI1sT1VQOl&q=85&s=8275c7a99ba2263d2f32f52459325126" alt="Image" width="2878" height="1458" data-path="images/image-9.png" />
</Frame>

### Step 4: Configure Text to Speech

<Frame>
  <img src="https://mintcdn.com/neosapienceinc/hrSZOoWI1sT1VQOl/images/image-10.png?fit=max&auto=format&n=hrSZOoWI1sT1VQOl&q=85&s=8fad958fb59b20f303f0b0234f67d65c" alt="Image" width="2876" height="1456" data-path="images/image-10.png" />
</Frame>

| Setting            | What to Enter                                             |
| ------------------ | --------------------------------------------------------- |
| **Text**           | Your text to convert (required)                           |
| **Model**          | `ssfm-v30 (Recommended)` — latest model with best quality |
| **Voice**          | Select from the dropdown (required)                       |
| **Language**       | Auto-detected, or select manually                         |
| **Emotion Type**   | `Preset` or `Smart` (v30 only)                            |
| **Emotion Preset** | Normal, Happy, Sad, Angry, Whisper, etc.                  |

### Step 5: Test and Publish

1. Click **Continue** to go to the Test step
2. Click **Test step** to generate sample audio
3. If successful, click **Publish** to activate your Zap

<Note>
  The generated audio URL will be available as output data. You can use it in subsequent steps to send via email, upload to cloud storage, or post to Slack.
</Note>

***

## Available Actions

### Create Speech From Text

Converts text to speech using Typecast AI voice models.

**Inputs:**

| Field             | Required | Description                                            |
| ----------------- | -------- | ------------------------------------------------------ |
| Text              | Yes      | Text to convert (max 2000 characters)                  |
| Model             | Yes      | `ssfm-v30` (recommended) or `ssfm-v21`                 |
| Voice             | Yes      | Select from 500+ available voices                      |
| Language          | No       | ISO 639-3 code (auto-detected if not set)              |
| Emotion Type      | No       | `Preset` or `Smart` (context-aware, v30 only)          |
| Emotion Preset    | No       | Normal, Happy, Sad, Angry, Whisper, Tone Up, Tone Down |
| Emotion Intensity | No       | 0.0 to 2.0 (default: 1.0)                              |
| Volume            | No       | 0 to 200 (default: 100)                                |
| Audio Pitch       | No       | -12 to +12 semitones (default: 0)                      |
| Audio Tempo       | No       | 0.5x to 2.0x speed (default: 1.0)                      |
| Audio Format      | No       | WAV or MP3                                             |
| Seed              | No       | For reproducible results                               |

**Outputs:**

* Audio File URL
* Speech ID
* Duration (seconds)
* Content Type

### List Voices (Search)

Lists all available voice models with enhanced metadata.

**Filters:**

* Model (ssfm-v30, ssfm-v21)
* Gender (Male, Female)
* Age (Child, Teenager, Young Adult, Middle Age, Elder)
* Use Cases (Audiobook, Podcast, E-learning, etc.)

### Get Voice by ID (Search)

Get detailed information for a specific voice including supported emotions per model.

### Recommend Voices (Search)

Find voice candidates from a text description.

**Inputs:**

| Field | Required | Description                                                                     |
| ----- | -------- | ------------------------------------------------------------------------------- |
| Query | Yes      | Text describing the desired style, mood, language, use case, or content context |
| Count | No       | Number of recommendations to return (1-10, default: 5)                          |

**Outputs:**

* Voice ID
* Voice Name
* Score

The recommendation response contains only `voice_id`, `voice_name`, and `score`; use List Voices or Get Voice by ID when a Zap needs detailed metadata before synthesis.

***

## Emotion Settings

Make your voice expressive with emotion controls!

### For SSFM-V30 (Latest Model)

Two ways to add emotion:

<CardGroup cols={2}>
  <Card title="Smart Emotion" icon="wand-magic-sparkles">
    AI automatically detects the best emotion from your text context. Perfect for natural conversations and storytelling.

    Add "Previous Text" and "Next Text" for better context understanding.
  </Card>

  <Card title="Preset Emotion" icon="sliders">
    Manually choose from 7 emotions: Normal, Happy, Sad, Angry, Whisper, Tone Up, Tone Down.
  </Card>
</CardGroup>

### For SSFM-V21

Choose from 4 emotions: `Normal`, `Happy`, `Sad`, `Angry`

Adjust **Emotion Intensity** (0.0 - 2.0):

* `0.0` — Completely neutral
* `1.0` — Standard (default)
* `2.0` — Maximum intensity

***

## Example Use Cases

<AccordionGroup>
  <Accordion title="Daily News Podcast">
    1. **Trigger**: RSS feed with new articles
    2. **Action**: Typecast creates audio from article summary
    3. **Action**: Upload to podcast hosting platform
  </Accordion>

  <Accordion title="Customer Support Auto-Reply">
    1. **Trigger**: New support ticket
    2. **Action**: AI generates response text
    3. **Action**: Typecast converts to voice message
    4. **Action**: Send via email or SMS
  </Accordion>

  <Accordion title="E-learning Content">
    1. **Trigger**: New lesson content in Google Sheets
    2. **Action**: Typecast generates narration
    3. **Action**: Upload to Google Drive
    4. **Action**: Notify team via Slack
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Can't find Typecast in Zapier">
    Search for "Typecast" in the Zapier app directory. Make sure you're using the latest version (2.0.0).
  </Accordion>

  <Accordion title="Authentication failed">
    * Check your API key is correct
    * Verify your key at [Typecast API Console](https://typecast.ai/developers/api/)
    * Make sure there are no extra spaces in the key
  </Accordion>

  <Accordion title="Voice dropdown is empty">
    * Check your API key has proper permissions
    * Try refreshing the field by clicking the refresh icon
  </Accordion>

  <Accordion title="No audio generated">
    * Check that your text is not empty
    * Verify you have sufficient API credits
    * Check the error message in the test output
  </Accordion>
</AccordionGroup>

***

## Resources

<CardGroup cols={2}>
  <Card title="Voice Library" icon="microphone" href="https://typecast.ai/developers/api/voices">
    Browse all available voices
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference">
    Explore the Typecast API
  </Card>

  <Card title="Zapier Help" icon="circle-question" href="https://help.zapier.com/">
    Zapier documentation and support
  </Card>
</CardGroup>