API keys, webhooks and developer tools

The Developers tab in Settings → Integrations has everything you need to build on Vidler. Only workspace owners and admins can create API keys, webhooks and SDK apps. Members see a note asking them to contact an admin.

API keys

1. Go to Settings → Integrations → Developers and click Create API key.
2. Give it a name you'll recognise, like the tool that uses it.
3. Choose its Access:
   • Read only: list and read videos, transcripts, comments and spaces.
   • Read and write: also upload videos and change titles, sharing and requests.
   • Admin: also keeps an owner's or admin's powers, such as other people's private videos, every video's viewers, and webhooks.
4. Click Create key and copy it. It's shown only once.

A key acts as the person who made it and never sees more than they can open. Use Change access to narrow or widen a key, and Revoke to stop it working.

Webhooks

A webhook sends a signed message to your server when something happens in Vidler.

1. Click Add webhook and enter an https Endpoint URL.
2. Choose Events: Video ready, Video failed, New viewer, View completed, Comment, Reply or Reaction.
3. Click Add webhook and copy the signing secret. Use it to check that each message really came from Vidler.

Each webhook has Send test event and View deliveries (every delivery for 30 days, with Send again). Its … menu has Edit webhook, Rotate secret… and Delete webhook…. Failed deliveries are retried for about an hour. After 20 failures in a row the webhook is switched off until you click Turn on webhook.

AI assistants (MCP)

Let Claude, ChatGPT, Cursor or VS Code search your videos, read transcripts and summaries, and comment or share for you. Each assistant signs in to Vidler and asks you to allow access, so anyone in the workspace can connect one without an API key. See Connect an AI assistant. Assistants that can't sign in can use an API key: the With an API key tab shows how.

Command line

The vidler command reads videos, transcripts, summaries and comments, and can upload, import and comment. The Command line section shows how to sign in with an API key and some example commands.

Imports, from the API or vidler import, need a public https link to the video file itself, or a Dropbox or Google Drive share link to it. A link to a video's page on another video service is refused with "That page can't be imported. Download the video file and upload it instead."

Zapier and Make

Point a Zapier or Make webhook step at Vidler as a webhook endpoint for instant triggers, or call the API with a key for actions. The Zapier and Make section lists what to use for each.

SDK apps

An SDK app lets people record a video on your own website without a Vidler account. Click Create app, list the Allowed origins it may run on, and choose whether Guest recording is on and how long recordings can be.

Reference

API reference at the bottom of the Developers tab covers authentication, uploading a video, verifying webhooks, and embedding the player or recorder.

Related

• Connect Vidler to your other tools
• Embed a video
• CRM and other apps