Castingwords

9 tools available

CastingWords offers high-quality, human-powered transcription services with a RESTful API for seamless integration into various workflows.

Connect Castingwords to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Castingwords's 9 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 Castingwords

01

Trigger on event

  1. Listen for a new event
  2. Parse and validate the payload
  3. Take an action with the linked tool
02

Daily summary

  1. Pull yesterday's activity
  2. Summarise with the model of your choice
  3. Send the digest via email or Slack
03

Cross-tool sync

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

Castingwords actions 9

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

Cancel and Refund Audio File

Tool to cancel an ordered audio file and issue a refund if applicable. Use when no transcription work has been done on the file (Pre-Processing, Audio Processing, Error states).

Get Prepay Balance

Tool to retrieve the current prepay balance for the account. Use when you need to check available funds before placing new transcription orders.

Get Transcript

Tool to retrieve the transcript for a given audiofile in the requested format (txt, doc, rtf, or html). Use after a transcription order has been completed.

Get registered webhook URL

Tool to retrieve the currently registered webhook URL for account notifications. Use when you need to verify your webhook setup.

Order Transcript

Create a transcription order for audio/video files at publicly accessible URLs. Returns order ID and audiofile IDs for tracking. Requires prepaid balance for non-test orders. Use test=true to validate URLs without charges.

Order Upgrades

Tool to order an upgrade for a specific audio file. Use after transcription is complete to add items like timestamps or extra editing. Example: 'Order timestamps for file 12345'.

Register Webhook

Registers a webhook URL to receive CastingWords event notifications. When events occur (e.g., transcript completion, refund issued, difficult audio), CastingWords will POST to your registered URL with event details. Use CASTINGWORDS_GET_WEBHOOK to verify the current webhook, and CASTINGWORDS_TEST_WEBHOOK to test notifications.

List Available SKUs

Retrieves all available CastingWords transcription service SKUs with pricing. Use this tool to discover available services (transcription, captions, etc.) and their per-minute prices before placing an order. Returns SKU codes needed for order placement.

Test Webhook Call

Tool to request a test webhook call for a specific event type. Use after registering a webhook URL to ensure webhook notifications are functioning properly.

Frequently asked questions

What can I automate with Castingwords on Definable?

Anything Castingwords 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 9 Castingwords tools directly, then chain the result into another integration without you writing code.

How does Castingwords authentication work?

Castingwords 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 Castingwords integration included in my Definable plan?

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

Is using Castingwords through Definable secure?

Every call from a persona to Castingwords 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 Castingwords on Definable?

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

What Castingwords actions does Definable expose?

Definable exposes all 9 Castingwords actions as callable tools — including `Cancel and Refund Audio File`, `Get Prepay Balance`, `Get Transcript`, plus 6 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Castingwords?

Wire it up in minutes. No coding required.

← All integrations