Skip to main content

API and Webhooks

How to access, set up and use our API and Webhooks

Updated yesterday

You already know that tl;dv is all about saving time and making work more streamlined. Using our Public API and Webhooks will make everything even simpler.

Here's how to access them, set them up and offloading even more work!

Public API

Our API allows you to import meetings and build custom workflows tailored to your needs. Access to API and webhooks is only available on the Business Plan.

  • Business Plan: API access included

  • Pro or Free Plans: API access not included or available

How to use tl;dv's Public API

To get started, you'll need:

  1. Your API key: You can find this in your Account Settings if you're on the Business Plan.

  2. Technical setup: Implementation usually requires a bit of coding, so a developer on your team may need to help.

It includes everything you need to start integrating.

Need help or want to upgrade?

If you're not super sure if you should have access or how to use it, we’re here if you have questions or want help upgrading to the Business Plan. Just reach out to support@tldv.io - we’re happy to help! 🙌


Webhooks

How to set up Webhooks to receive meeting data

Want to automate workflows by receiving meeting data in real time? We can configure a webhook for you! Once it's set up, we’ll send you a payload as soon as a meeting (or its transcript) is ready, without need to poll our API.

How it works

Webhooks let you receive a notification when:

  • A meeting is successfully processed (MeetingReady)

  • A transcript is available (TranscriptReady)

Each webhook includes rich metadata, ideal if you're building custom automations or integrations, and each event sends a JSON payload that matches the format used in our Public API.

Here’s what it looks like for a Meeting ready event:

{
"id": "webhook-job-id",
"event": "MeetingReady",
"executedAt": "2025-06-16T09:23:00Z",
"data": {
"id": "meeting-id",
"happenedAt": "2025-06-15T14:00:00Z",
"name": "Team Sync",
"organizer": {
"email": "organizer@example.com",
"name": "Alex Taylor"
},
"invitees": [
{
"email": "teammate@example.com",
"name": "Jordan Lee"
}
],
"url": "https://app.tldv.io/meetings/meeting-id"
}
}

Here’s what it looks like for a Transcript ready event:

{
"event":"TranscriptReady",
"data {
"id":"meeting-id",
"meetingId":"68d6a361f276f00013c36317",
"data":[
{"startTime":1,
"endTime":14,
"speaker":"User name",
"text":"September the 26th. Let's test how this is being transcribed. Transcription, the transcription. We are getting a transcription."}]},
"id":"webhook-job-id",
"executedAt":"2025-09-26T14:33:03.605Z"
}

Note: Calendar Event meta data is absent while using the "Transcript Ready". This includes Meeting Organizer and Meeting invitees.

How to create your Webhooks:

  1. In your TLDV account, Navigate into Settings > Webhooks

  2. Press "Configure new Webhook" and fill in the required fields: "Event Action" and "Endpoint URL" - Important - The URL provided must support https.

  3. Optionally, Header Config: Any extra configuration or headers (e.g. auth tokens) you want us to include in the request.

  4. Press "Save and activate webhook" and from that point on all events from your user, that meet the set configuration will be sent through the Webhook.


Did this answer your question?