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

# Zapier Integration with AssemblyAI

Zapier is a workflow automation tool that lets you integrate various services together without requiring coding knowledge.
You can use our AI models to process audio data by transcribing it with speech recognition models and analyzing it with speech understanding models.
You can supply audio to the AssemblyAI app and connect the output of our models to other services in your Zaps.

## Quickstart

<Steps>
  <Step>
    In your Zap editor, add an action, search for `AssemblyAI` and select the AssemblyAI app.

    <img src="https://mintcdn.com/assemblyai-fff14a6f/QiQdgq4Y8it2UHbH/assets/img/integrations/zapier/1-change-action.png?fit=max&auto=format&n=QiQdgq4Y8it2UHbH&q=85&s=f69b877b131b4156f48e87f79c4931b9" alt="Change action Zapier screen, with AssemblyAI in search box." width="1010" height="260" data-path="assets/img/integrations/zapier/1-change-action.png" />
  </Step>

  <Step>
    Next, configure the action.
    In the **App & event** tab, select **Transcribe** for the **Event** dropdown, then click **Continue**.

    <img src="https://mintcdn.com/assemblyai-fff14a6f/QiQdgq4Y8it2UHbH/assets/img/integrations/zapier/2-app-event.png?fit=max&auto=format&n=QiQdgq4Y8it2UHbH&q=85&s=ae23dfade6fdc73f9739cbacda7fd639" alt="App & event Zapier tab with Event field set to &#x22;Transcribe&#x22;." width="1130" height="882" data-path="assets/img/integrations/zapier/2-app-event.png" />
  </Step>

  <Step>
    Then, in the **Account** tab, click **Sign in** which will open a separate window.
    In the window, enter your AssemblyAI API key in **API Key** field, and click **Yes, Continue to AssemblyAI**.
    Back in the Zap editor, click **Continue**.

    <img src="https://mintcdn.com/assemblyai-fff14a6f/QiQdgq4Y8it2UHbH/assets/img/integrations/zapier/3-account.png?fit=max&auto=format&n=QiQdgq4Y8it2UHbH&q=85&s=9fbc44e062aa96df24ac7efa9352fdf6" alt="Account Zapier tab where you are prompted to Connect AssemblyAI with a Sign in button." width="1130" height="886" data-path="assets/img/integrations/zapier/3-account.png" />
  </Step>

  <Step>
    In the **Action** tab, enter the URL of the audio or video file you want to transcribe in the **Audio URL** field.
    The URL has to be publicly accessible. Click **Continue**.

    <img src="https://mintcdn.com/assemblyai-fff14a6f/QiQdgq4Y8it2UHbH/assets/img/integrations/zapier/4-action.png?fit=max&auto=format&n=QiQdgq4Y8it2UHbH&q=85&s=80b77dd7901ac167934535eab736823f" alt="Action Zapier tab where you are prompted to enter the Audio URL to transcribe using AssemblyAI." width="1134" height="1228" data-path="assets/img/integrations/zapier/4-action.png" />
  </Step>

  <Step>
    Finally, you can test the action. You can use all the fields returned by the action in subsequent steps.

    <Note>
      All AssemblyAI actions return sample data during testing instead of running
      the action. This makes it easier to build your Zaps, however, you have to test
      using normal Zap runs to verify everything is working correctly. Learn more
      about why we [return sample data during testing
      below](#testing-with-sample-data).
    </Note>

    <img src="https://mintcdn.com/assemblyai-fff14a6f/QiQdgq4Y8it2UHbH/assets/img/integrations/zapier/5-test.png?fit=max&auto=format&n=QiQdgq4Y8it2UHbH&q=85&s=4347e95ff86e5872e94c973299988010" alt="Test Zapier tab where you can see the output of the AssemblyAI Transcribe action." width="1132" height="1278" data-path="assets/img/integrations/zapier/5-test.png" />
  </Step>
</Steps>

## Zapier Actions

### Transcribe

Transcribe an audio file and wait until the transcript has completed or failed.
Configure the `Audio URL` field with the URL of the audio file you want to transcribe.
The `Audio URL` must be accessible by AssemblyAI's servers.

If you don't want to wait until the transcript is ready, change the `Wait until Transcript is Ready` parameter to `False`.

### Get Transcript

Retrieves a transcript by its ID.

### Get Subtitles

Export the transcript as SRT or VTT subtitles.

<Note>You can only invoke this action after the transcript is completed.</Note>

### Get Sentences

Retrieve the sentences of the transcript by its ID.

<Note>You can only invoke this action after the transcript is completed.</Note>

### Get Paragraphs

Retrieve the paragraphs of the transcript by its ID.

<Note>You can only invoke this action after the transcript is completed.</Note>

## Testing with sample data

A transcript goes through multiple phases to transcribe audio, reflected by different statuses.
The initial status is typically `processing`, and the final status is either `completed` or `error`. A transcript may also have a `queued` status if the job is waiting to be processed (for example, when you've exceeded your rate limit).
**During a normal Zap run**, the Transcribe event will wait until the transcript status is `completed`, and throw an error if the status is `error`.
Unfortunately, this is not the case during testing.

Because of a Zapier platform limitation, **during testing**, the Transcribe event will return a transcript before it has reached the `completed` status.
A transcript that does not have the `completed` status cannot be used in subsequent tests.

This way you can easily test using sample data, but you still have to use normal Zap runs to verify the end-to-end functionality.

## Additional resources

You can learn more about using Zapier with AssemblyAI in these resources:

* [How to generate subtitles for your videos using the AssemblyAI app for Zapier](https://www.assemblyai.com/blog/generate-subtitles-with-zapier)
* [How to get started with AssemblyAI on Zapier](https://help.zapier.com/hc/en-us/articles/16411509681933-How-to-get-started-with-AssemblyAI-on-Zapier)
* [AssemblyAI app on Zapier](https://zapier.com/apps/assemblyai/integrations)
