api.video
SearchCtrl K

Features

Developers

Updated: our Zapier integration now features instant triggers

October 25, 2021 - Doug Sillars in no code

Zapier is a no-code platform that makes it easy to connect services together - without writing a single line of code.

We recently upgraded our Zapier integration to make use of our API webhooks, so that Zapier can instantly report when an event occurs at api.video.

Our webhooks

We currently have 4 alerts from our webhooks:

  • video.encoding.quality.completed: This alert fires when a video quality is ready to playback.
  • live-stream.broadcast.started: Alerts you to when a live stream has begun.
  • live-stream.broadcast.ended: The opposite alert - the live stream has ended.
  • video.source.recorded: Similar to the first, but specifically for when a livestream recording quality is ready.

Now available in Zapier

When the webhook alert from api.video occurs, Zapier is alerted immediately. That's why Zapier calls these triggers "Instant triggers"- there is no polling delay to know when the Zap must begin:

api.video's instant Zaps

As shown in the above screenshot, there are currently 4 instant Zap triggers offered by api.video.

  • Live stream started This alert will fire whenever a livestream has started. You can filter on the liveStreamId to create a custom integration for a specific live stream ("when stream liXXX goes live - send a alert to a Discord channel), or have it fire for all of our live streams (livestream "liYYY" is now live. Watch it here ")
  • Live stream started this is the opposite of the first alert - so the Discord channel knows the stream has ended "sorry you missed us, tune in tomorrow".
  • Video encoded completed This webhook fires for each version of the video created. Currently, api.video encodes video at 240p, 360p, 480p, 720p, 1080p and 2160p. When you create the Zap, you choose which size you wish to be alerted on. For example, if you only want to show a video once the quality has reached 480p, you define the Zap to trigger when the 480p version of the video is ready,and then you'll receive that alert.
  • All live events: This webhook incorporates all 3 live stream webhook events: started, ended and video.source.recorded (at a specific resolution). This allows you to create more elaborate Zaps with various paths based on the results - while just using one webhook.

Each Zap you create with the instant triggers will create a webhook at api.video (and when you disable the Zap, the webhook will be removed).

Note: There is a limit of 10 webhooks per account at api.video, so there should be some consideration on how the number of "instant Zaps" will affect your webhook limits.

In the below example, we use Zapier paths and the All Live Events trigger to do 3 different things - depending on the event type that is reported. (Note: Zapier paths require a "professional" level Zapier account.)

We're very excited to see how instant Zaps can help our no-code developers build apps that react instantly to changes in their api.video account.

These Triggers are all live at zapier.com, and our docs are updated with more details on how to integrate each trigger and action

Doug Sillars

Head of Developer Relations

Create your free account

Start building with video now