Shotstack

24 tools available

Shotstack is a cloud-based platform that enables developers, marketers, and designers to automate the generation of videos, images, and audio at scale using a RESTful API.

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

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

Shotstack actions 24

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

Create Template

Tool to create a new template for video editing. Use when you want to save a reusable timeline configuration as a template. Template changes do not retroactively affect past renders.

Create Template (v2)

Tool to save an Edit as a re-usable template. Templates can be retrieved and modified before rendering. Use when you want to create a template with merge fields for dynamic content.

Delete Ingested Media

Tool to delete an ingested media asset. Use when you've confirmed the ingest ID and need to remove the file from Shotstack storage.

Delete Template

Tool to delete a specific Shotstack template by its ID. Use when you need to remove a template permanently.

Delete Shotstack Workflow

Tool to delete a specific Shotstack workflow. Use when you need to permanently remove a workflow after confirming its ID.

Fetch Source

Tool to fetch a remote media file and store it as a source asset. Operation is asynchronous — poll SHOTSTACK_GET_INGEST_STATUS or SHOTSTACK_INSPECT_MEDIA until the asset is ready before passing it to SHOTSTACK_RENDER_VIDEO or other downstream tools. Use when you need to ingest a file before rendering.

Get Asset

Tool to fetch details of a hosted asset by its unique identifier. Use when you need to retrieve information about videos, images, audio files, thumbnails, or poster images hosted on Shotstack's CDN.

Get Assets by Render ID

Tool to retrieve hosted assets by render ID. Use when you need to fetch one or more files (video, thumbnail, poster image) generated by a specific render job.

Get Ingest Status (Deprecated)

DEPRECATED: Use SHOTSTACK_GET_SOURCE instead. Tool to retrieve the status and details of an ingested media asset. Poll until the asset status is 'ready' before using it in SHOTSTACK_RENDER_VIDEO; rendering against an unprocessed asset causes missing clips or failed renders.

Get Render Callback

Tool to retrieve the webhook/callback URL configuration for a specific render job. Returns only callback settings (URL, method, headers), not render status or output URLs — use a separate render-status check to obtain final results.

Get Render Status

Tool to retrieve the current status and details of a Shotstack render job by render ID. Use when polling a render until done or failed, typically after creating a render with SHOTSTACK_RENDER_VIDEO.

Get Source Details

Tool to fetch the details of a specific source asset. Use when you need to inspect a source after uploading, check its status, or diagnose ingest/render failures—such as unsupported codecs, corrupt files, or bad URLs—before retrying.

Get Template

Tool to retrieve details of a specific template. Use when you have the ID of an existing template and need its metadata.

Get Template By Version

Tool to retrieve a template by template id and API version. Use when you need to fetch template details from a specific Edit API version.

Get Upload URL

Tool to request a signed URL for direct file upload to Shotstack. Use when you need to upload a file to Shotstack storage. The response returns a signed URL that you use to upload the file using a PUT request with the binary file.

Inspect Media

Tool to inspect media metadata. Use before rendering to retrieve duration, resolution, frame rate, and format of an online media file — clip timecodes, trim points, and audio sync calculations depend on these values. Mixing assets without prior inspection can cause letterboxing, jitter, or audio sync issues in the final output.

List Sources

Tool to list all source assets. Use when you need to retrieve source entries with optional pagination.

List Sources (with Environment)

Tool to list all ingested source files with environment selection. Use when you need to retrieve sources from stage (sandbox) or v1 (production) environment with optional pagination.

List Templates

Tool to list all Shotstack templates for the account. Use after creating or updating templates to view your available templates.

List Templates with Environment

Tool to list all Shotstack templates for the specified environment. Use when you need to retrieve templates from a specific environment (stage or production).

Request Upload URL

Tool to request a signed URL for direct file upload. Use when you need to upload a file to Shotstack storage. The response returns a signed URL that expires in one hour.

Render Video

Tool to initiate a new video render job. Use when you have defined a timeline and output settings and want to start rendering.

Transfer Asset

Tool to transfer a file from any publicly available URL to one or more Serve API destinations. Use when you need to copy a file from an external source to Shotstack's hosting service or other configured destinations.

Update Template

Tool to update an existing template by its ID. Use when you need to modify a template's name or edit configuration. Both name and complete template definition must be provided.

Frequently asked questions

What can I automate with Shotstack on Definable?

Anything Shotstack exposes through its API. Common video & audio 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 24 Shotstack tools directly, then chain the result into another integration without you writing code.

How does Shotstack authentication work?

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

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

Is using Shotstack through Definable secure?

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

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

What Shotstack actions does Definable expose?

Definable exposes all 24 Shotstack actions as callable tools — including `Create Template`, `Create Template (v2)`, `Delete Ingested Media`, plus 21 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Shotstack?

Wire it up in minutes. No coding required.

← All integrations