# Amara — Pipedream Connect

> The Amara Editor is an award-winning caption and subtitle editor that’s free to use! It’s fun and easy to learn, and encourages collaboration.

- API slug: `amara` (use in MCP headers and tool keys)
- Auth: API key (Pipedream-managed)
- Categories: Productivity
- Website: https://amara.org
- This page (HTML): https://pipedream.com/apps/amara
- Tools: 16 actions · 6 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: amara`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "amara",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Add New Subtitles:
const result = await mcp.callTool({
  name: "amara-add-new-subtitles",
  arguments: {
    team: "Team",
    videoId: "Video ID",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Amara endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://amara.org/api/users/teams/

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hbWFyYS5vcmcvYXBpL3VzZXJzL3RlYW1zLw?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "amara-add-new-subtitles",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    amara: { authProvisionId: "apn_xxxxxxx" },
    team: "Team",
    videoId: "Video ID",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (16)

### `amara-add-new-subtitles` — Add New Subtitles (Write)

Add new subtitles. See the docs here

Full schema: https://pipedream.com/apps/amara/actions/add-new-subtitles.md

### `amara-add-video` — Add Video (Write)

Add a video. See the docs here

Full schema: https://pipedream.com/apps/amara/actions/add-video.md

### `amara-create-subtitle-language` — Create Subtitle Language (Write)

Create a subtitle language. See the docs here

Full schema: https://pipedream.com/apps/amara/actions/create-subtitle-language.md

### `amara-delete-subtitles` — Delete Subtitles (Write)

Delete all subtitle versions for a language. See the docs here

Full schema: https://pipedream.com/apps/amara/actions/delete-subtitles.md

### `amara-delete-video` — Delete Video (Write)

Delete a video. In order to delete a video, it must be part of a team that you're an admin of. See the docs here

Full schema: https://pipedream.com/apps/amara/actions/delete-video.md

### `amara-fetch-raw-subtitles` — Fetch Raw Subtitles (Write)

Fetch raw subtitles. See the docs here

Full schema: https://pipedream.com/apps/amara/actions/fetch-raw-subtitles.md

### `amara-fetch-subtitles-data` — Fetch Subtitles Data (Write)

Fetch subtitles data. See the docs here

Full schema: https://pipedream.com/apps/amara/actions/fetch-subtitles-data.md

### `amara-get-subtitle-language-details` — Get Subtitle Language Details (Read-only)

Get details on a single subtitle language. See the docs here

Full schema: https://pipedream.com/apps/amara/actions/get-subtitle-language-details.md

### `amara-get-team-details` — Get Team Details (Read-only)

Get details on a team. See the docs here

Full schema: https://pipedream.com/apps/amara/actions/get-team-details.md

### `amara-get-video-details` — Get Video Details (Read-only)

Get video details. See the docs here

Full schema: https://pipedream.com/apps/amara/actions/get-video-details.md

### `amara-list-primary-audio-language-code-options` — List Primary Audio Language Code Options (Read-only)

Retrieves Available Options for the Primary Audio Language Code Field.

Full schema: https://pipedream.com/apps/amara/actions/list-primary-audio-language-code-options.md

### `amara-list-teams` — List Teams (Read-only)

List teams. See the docs here

Full schema: https://pipedream.com/apps/amara/actions/list-teams.md

### `amara-list-video-subtitle-languages` — List Video Subtitle Languages (Read-only)

Get a list of subtitle languages for a video. See the docs here

Full schema: https://pipedream.com/apps/amara/actions/list-video-subtitle-languages.md

### `amara-list-videos` — List Videos (Read-only)

List videos. See the docs here

Full schema: https://pipedream.com/apps/amara/actions/list-videos.md

### `amara-perform-action` — Perform Action (Write)

Perform an action on the subtitles. This is equivalent to opening the editor, not changing the subtitles, and clicking an actions button. See the docs here

Full schema: https://pipedream.com/apps/amara/actions/perform-action.md

### `amara-update-subtitle-language` — Update Subtitle Language (Write)

Update a subtitle language. See the docs here

Full schema: https://pipedream.com/apps/amara/actions/update-subtitle-language.md

## Triggers (6)

### `amara-subtitles-published` — Subtitles Published (Polling)

Emit new event when subtitles have been published. See the docs here

Full schema: https://pipedream.com/apps/amara/triggers/subtitles-published.md

### `amara-subtitles-unpublished` — Subtitles Unpublished (Polling)

Emit new event when subtitles have been unpublished. See the docs here

Full schema: https://pipedream.com/apps/amara/triggers/subtitles-unpublished.md

### `amara-video-added` — Video Added (Polling)

Emit new event when a video is added. See the docs here

Full schema: https://pipedream.com/apps/amara/triggers/video-added.md

### `amara-video-deleted` — Video Deleted (Polling)

Emit new event when a video is deleted. See the docs here

Full schema: https://pipedream.com/apps/amara/triggers/video-deleted.md

### `amara-video-made-primary` — Video Made Primary (Polling)

Emit new event when a video has been made primary. See the docs here

Full schema: https://pipedream.com/apps/amara/triggers/video-made-primary.md

### `amara-video-moved-project` — Video Moved Project (Polling)

Emit new event when a video has been moved from project. See the docs here

Full schema: https://pipedream.com/apps/amara/triggers/video-moved-project.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt