Happy Scribe

20 tools available

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

transcription

Connect Happy Scribe Visit Happy Scribe ↗

Connect Happy Scribe to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Happy Scribe's 20 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.

Common workflows with Happy Scribe

Trigger on event

Listen for a new event
Parse and validate the payload
Take an action with the linked tool

Daily summary

Pull yesterday's activity
Summarise with the model of your choice
Send the digest via email or Slack

Cross-tool sync

Read records from one app
Transform with a persona
Write the result back via this integration

Happy Scribe actions 20

Every Happy Scribe action below is a callable tool any Definable persona can invoke.

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.

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).

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.

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.

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.

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.

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 [email protected] with subject "Happy Scribe for Business".

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.

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.

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.

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

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).

Get Error Codes

Returns a list of HTTP error codes used by the Happy Scribe API along with their descriptions. Use this tool to understand what different error responses mean when calling other Happy Scribe API endpoints. This returns static reference data matching the official Happy Scribe API documentation.

Get Supported Formats

Tool to retrieve supported file formats. Use when you need to know available input and output formats before creating a transcription or subtitle. If a dedicated '/formats' endpoint is unavailable, this action probes known endpoints to verify connectivity and returns a curated list based on official documentation.

Get Transcription Details

Tool to retrieve details and status of a specific transcription job. Use after creating or listing transcription jobs to inspect a particular job's metadata.

Get Webhooks

Tool to retrieve webhooks configured for your account. Note: Happy Scribe's public API does not have a dedicated webhooks listing endpoint. Webhooks are specified via webhook_url when creating orders. This action attempts common endpoints and returns an empty list if unavailable.

Retrieve Export

Tool to retrieve information about a specific export. Use when you need to check export status and get download link.

Retrieve Translation Task

Retrieves the status and details of a translation task by its ID. Use this after creating a translation task with HAPPY_SCRIBE_CREATE_TRANSLATION_TASK to check progress (state: initial, working, failed, done) and obtain the translated transcription ID when complete. Note: This endpoint is deprecated; consider using HAPPY_SCRIBE_RETRIEVE_ORDER for new integrations.

List Transcriptions

Retrieves a paginated list of transcription jobs for a Happy Scribe organization. Returns transcription metadata including ID, name, processing state, language, and duration. Supports filtering by folder and tags, with pagination for large result sets. Note: This returns metadata only; use the Export Transcription action to get actual transcript content.

Retrieve Order

Retrieve details of a Happy Scribe order by its ID. Returns order state, pricing, operations, and inputs. Use this to check order status, verify pricing details, or get information about translation/transcription operations. The order ID is obtained from create order responses (e.g., Create Translation Order).

Frequently asked questions

What can I automate with Happy Scribe on Definable?

Anything Happy Scribe exposes through its API. Common transcription workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 20 Happy Scribe tools directly, then chain the result into another integration without you writing code.

How does Happy Scribe authentication work?

Happy Scribe uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Happy Scribe integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 20 Happy Scribe tools. You only need a separate Happy Scribe subscription if Happy Scribe itself charges per seat or per API call.

Is using Happy Scribe through Definable secure?

Every call from a persona to Happy Scribe is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Happy Scribe on Definable?

Sign up for Definable, open the integrations page, find Happy Scribe, and connect via OAuth or API key. You can immediately attach Happy Scribe to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Happy Scribe actions does Definable expose?

Definable exposes all 20 Happy Scribe actions as callable tools — including `Create Subtitle`, `Create Translation Task`, `Delete Transcription`, plus 17 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Happy Scribe?

Wire it up in minutes. No coding required.

Start for free Schedule a demo

← All integrations