1. 1

   Create a webhook in Contentful

   In the Contentful web app, go to Settings → Webhooks and create a new webhook. Set the trigger to fire on Entry.publish for your video content type. Point the webhook URL to your middleware endpoint.

   This step is completed in the Contentful web app — see Contentful webhooks documentation

2. 2

   Build your middleware

   Create a serverless function (AWS Lambda, Cloudflare Workers, or similar) that receives the Contentful webhook payload, extracts the video asset URL, and submits a Qencode transcoding job via the Qencode API. Set the Qencode callback URL to another endpoint on your middleware.

3. 3

   Map Contentful fields to Qencode parameters

   In your middleware, map the Contentful asset URL to the Qencode source parameter. Configure the output format, destination storage, and any additional features (thumbnails, captions, etc.).

4. 4

   Write playback URLs back to Contentful

   In your callback handler, parse the Qencode job result and use the Contentful Content Management API to update the original entry with the playback URLs (e.g., hls_url, dash_url, thumbnail_url fields).

   You need a Content Management API token with write access to the target content type.

For a step-by-step walkthrough, see Tutorial: Contentful Integration