---
id: guides-send-vercel-webhooks-to-tinybird
title: Send Vercel Webhooks to Tinybird
meta:
    description: In this guide you'll learn how to send Vercel events to Tinybird using webhooks and the Events API.
---

# Send Vercel events to Tinybird

[Vercel](https://vercel.com) is a platform for building and deploying web applications. By integrating Vercel with Tinybird, you can analyze your Vercel events in real time and enrich it with other data sources.

Some common use cases for sending Vercel events to Tinybird include:

1. Tracking deployments, projects, integrations and domains status and errors.
3. Creating custom analytical dashboards.
4. Monitoring attacks.

Read on to learn how to send data from Vercel to Tinybird.

## Before you start

Before you connect Vercel webhooks to Tinybird, ensure:

* You have a Vercel account.
* You have a Tinybird workspace.

## Connect Vercel to Tinybird

1. Choose your team scope on the dashboard, and go to **Settings** > **Webhooks**.

2. Select the Webhooks and Projects you want to send to Tinybird.

3. In Tinybird, create a data source, called `vercel`. You can follow this [schema](https://github.com/tinybirdco/tinynest/blob/main/tinybird/datasources/vercel.datasource):

```tb {% title = 'Data Source schema for Vercel webhooks %}
SCHEMA >
  `event_time` DateTime `json:$.tinybirdIngestTime` DEFAULT now(),
  `event_type` String `json:$.type` DEFAULT 'unknown',
  `event` JSON `json:$` DEFAULT '{}'

ENGINE "MergeTree"
ENGINE_PARTITION_KEY "toYYYYMM(event_time)"
ENGINE_SORTING_KEY "event_time"
```

Using the [JSON Data Type](/sql-reference/data-types/json) you can store the semi-structured data you receive from Vercel webhooks in a single column. You can later retrieve various events and their metadata as needed in your pipes.

{% callout type="caution" %}
The `JSON` data type is in private beta. If you are interested in using this type, contact Tinybird at <support@tinybird.co> or in the [Community Slack](/community).
{% /callout %}

4. In Tinybird, copy a token with privileges to append to the data source you created. You can use the admin token or create one with the required scope.

5. Back in Vercel, paste the Events API URL in your Webhook Endpoint URL. Use the query parameter `name` to match the name of the data source you created in Tinybird. For example:

```
{% user("apiHost") %}/v0/events?name=vercel&token={% user("userToken") %}
```

{% snippet title="api-region-reminder" /%}

6. You're done. Any of the Vercel events you selected is automatically sent to Tinybird through the [Events API](../events-api).

You can check the status of the integration from the **Log** tab in the Tinybird `vercel` data source.

## See also

* [Events API](../events-api)
* [Vercel webhooks](https://vercel.com/docs/observability/webhooks-overview)