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:

Your API key: You can find this in your Account Settings if you're on the Business Plan.
Technical setup: Implementation usually requires a bit of coding, so a developer on your team may need to help.

👉 View our API Documentation

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:

{
  "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"
  }
}

Once enabled, we’ll trigger the webhook every time you organize a meeting and it’s successfully processed. If transcripts are regenerated later, you’ll get an additional TranscriptReady event too.

What we need from you

Since you can't set up the webhooks on your end, just send us the following info so we can set it up for you:

Webhook URL: The endpoint you want us to send data to.
User’s Email: The email address of the user the webhook should be tied to.
Optional Header Config: Any extra configuration or headers (e.g. auth tokens) you want us to include in the request.

Send this to us via chat or email (support@tldv.io), and we’ll take care of the rest. 🔮