---
title: "Actions"
description: "The Speak Upload automation action ingests a file and transcribes it with no manual upload. Pair it with an inbound webhook trigger."
---

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

# Actions

The **Speak Upload** action ingests a file into Speak AI and transcribes it automatically inside an automation, with no manual upload. Pair it with the **Catch inbound webhook** trigger to send a file URL from an outside tool and have Speak AI transcribe it hands-free. For how to build and trigger automations, see [How to use automations in Speak AI](/help/automations/).


## When you can add Speak Upload

The **Speak Upload** action appears in the step list once a trigger earlier in the automation passes data downstream, such as the **Catch inbound webhook** trigger. Add the webhook trigger first, then add **Speak Upload** as a later step.

## Configure the Speak Upload step

Open the step to set these fields:

- **Name**: an optional name for the uploaded media. You can use a token here, for example a value from the webhook payload.
- **Folder**: the destination folder for the media. This is required.
- **Source**: choose **From URL** or **Uploaded file**. To ingest a file URL from the webhook, choose **From URL**.
- **File URL**: the link to the file to upload. Use the captured value picker to insert a value from the webhook payload, for example a token like `#{{trigger.payload.<path>}}`.
- **Processing language**: the language used to transcribe the file. Pick from the language list.

## Map custom fields

Below the main form, the **Map custom fields** section lets you write captured webhook values into your custom fields on the media. The empty state reads **Map a captured webhook value into one of your custom fields**. Use this to carry metadata, such as a contact name or record ID, straight from the request onto the transcribed media.

## How the flow runs end to end

1. An external tool POSTs a request, including a file URL, to your inbound webhook URL.
1. The **Speak Upload** step reads the **File URL** from the payload, uploads the file into the chosen **Folder**, and transcribes it in the selected **Processing language**.
1. Any values set in **Map custom fields** are written onto the new media.

You can watch each run land under the trigger’s **Recent deliveries** list, where a successful run shows the **Ran** status.

The fastest way to reach us is the live chat in the app (the chat bubble in the bottom corner). You can also email [success@speakai.co](mailto:success@speakai.co).

Want a hand setting this up? [Book a free consult](https://calendly.com/speak-ai/consult?utm_source=docs&utm_campaign=consult) and we'll do it together on your account.

---
Related: [Automations](/help/automations/) · [Filters](/help/automations/filters/)

Source: https://docs.speakai.co/help/automations/actions/index.mdx