# Happy Scribe AI integration on Definable

> Happy Scribe offers automatic and professional transcription services, converting audio and video files into text with high accuracy.

## What this connects

Happy Scribe offers automatic and professional transcription services, converting audio and video files into text with high accuracy.

Vendor: https://www.happyscribe.com/

## Tools available

**20** tools available. First 12:

- `HAPPY_SCRIBE_CREATE_SUBTITLE` — Create Subtitle — Create subtitles for a video file using Happy Scribe's automatic transcription service. Submits a video URL to be processed for subtitle generation. The video must be publicly accessible during ingestion. Returns a subtitle job with an editor URL for reviewing and editing the generated subtitles. Processing states progress from 'initial' -> 'ingesting' -> 'automatic_done' (or 'failed'). Use the GET transcription endpoint to check processing status.
- `HAPPY_SCRIBE_CREATE_TRANSLATION_TASK` — Create Translation Task — Creates an AI-powered translation task to translate an existing transcription into another language. Use this after a transcription is complete (state='automatic_done') to translate it. The task runs asynchronously - use Retrieve Translation Task to check progress and get results. Note: Not all language pairs are supported (e.g., German to English may fail).
- `HAPPY_SCRIBE_DELETE_TRANSCRIPTION` — Delete Transcription — Tool to delete a transcription job. Use when you have a transcription ID and want to remove it, optionally permanently. Use after confirming the transcription ID.
- `HAPPY_SCRIBE_DELETE_WEBHOOK` — Delete Webhook — Deletes a webhook by its ID. This action is idempotent: if the webhook does not exist or was already deleted, it returns success. Use Get Webhooks to retrieve available webhook IDs.
- `HAPPY_SCRIBE_GET_ACCOUNT_DETAILS` — Get Account Details — Tool to retrieve details about your account, including subscription status and usage statistics. Use after authenticating your API key to monitor plan and usage.
- `HAPPY_SCRIBE_GET_LANGUAGE_LIST` — Get Supported Languages — Retrieve the list of supported language codes for Happy Scribe transcription services. Returns BCP-47 language codes and indicates which languages have human transcription service available. This is a static reference based on Happy Scribe's official documentation, as there is no dedicated languages API endpoint.
- `HAPPY_SCRIBE_GET_RATE_LIMIT` — Get API Rate Limit — Get Happy Scribe API rate limit information. Returns the documented rate limit for the Happy Scribe API: - Default limit: 200 requests per hour - Applies only to the transcription creation endpoint - When rate limited, API returns HTTP 429 with 'retry_in_seconds' in the body Note: Happy Scribe does not expose rate limit headers, so this tool provides documented defaults. If you encounter a 429 response during transcription creation, wait for the 'retry_in_seconds' value before retrying. For higher limits, contact sales@happyscribe.co with subject "Happy Scribe for Business".
- `HAPPY_SCRIBE_GET_SIGNED_UPLOAD_URL` — Get Signed Upload URL — Tool to get a signed URL for uploading a file to Happy Scribe's S3 storage. Use before creating a transcription or order to obtain a secure upload URL for your media file.
- `HAPPY_SCRIBE_HS_CONFIRM_ORDER` — Confirm Order — Tool to confirm a pending order. Use after creating an order with confirm=false when you're ready to submit it for processing.
- `HAPPY_SCRIBE_HS_CREATE_TRANSLATION_ORDER` — Create Translation Order — Tool to create a translation order from an existing transcription. Use when you have a completed transcription and want translations into one or more languages. By default, the order remains incomplete unless confirm=true.
- `HAPPY_SCRIBE_HS_EXPORT_TRANSCRIPTION` — Export Transcription — Creates an export job to download transcription content in various formats. Use this action after a transcription job completes (state='automatic_done'). First obtain transcription IDs using the List Transcriptions action. The export job runs asynchronously - poll the Retrieve Export action with the returned export ID to check when the download URL becomes available (state='ready'). Supported formats: - Documents: txt, docx, pdf (support timestamps, speakers, comments, highlights) - Subtitles: srt, vtt, stl (standard caption formats) - Video editing: avid, premiere, fcp (professional editing software) - Other: html, json, maxqda
- `HAPPY_SCRIBE_HS_GET_API_VERSION` — Get API Version — Tool to retrieve current API version and check for updates. If Happy Scribe does not expose a dedicated /version endpoint, this tool attempts to infer the version from HTTP response headers or from the base_url path (e.g., /api/v1).

## Auth

Auth schemes: `API_KEY`.

## How agents use Happy Scribe

Inside a Definable workflow, Happy Scribe is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Happy Scribe** — the Researcher (GPT-5.5) pulls context from Happy Scribe (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Happy Scribe** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Happy Scribe (create record, post message, draft email).
- **Designer / Engineer → Distributor → Happy Scribe** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Happy Scribe (attach file, open PR comment, post status).

The Verifier checks every Happy Scribe call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- transcription — https://definable.ai/apps/category/transcription/

## Related

- HTML page: https://definable.ai/apps/happy_scribe/
- Same category (transcription): https://definable.ai/apps/category/transcription/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt