mirror of
https://github.com/supabase/supabase.git
synced 2026-07-03 06:14:29 +08:00
86 lines
2.6 KiB
Plaintext
86 lines
2.6 KiB
Plaintext
---
|
|
id: 'webhooks'
|
|
title: 'Database Webhooks'
|
|
description: 'Trigger external payloads on database events.'
|
|
subtitle: 'Trigger external payloads on database events.'
|
|
tocVideo: 'codAs9-NeHM'
|
|
---
|
|
|
|
Database Webhooks allow you to send real-time data from your database to another system whenever a table event occurs.
|
|
|
|
You can hook into three table events: `INSERT`, `UPDATE`, and `DELETE`. All events are fired _after_ a database row is changed.
|
|
|
|
## Webhooks vs triggers
|
|
|
|
Database Webhooks are very similar to triggers, and that's because Database Webhooks are just a convenience wrapper around triggers using the [pg_net](/docs/guides/database/extensions/pgnet) extension. This extension is asynchronous, and therefore will not block your database changes for long-running network requests.
|
|
|
|
This video demonstrates how you can create a new customer in Stripe each time a row is inserted into a `profiles` table:
|
|
|
|
<div className="video-container">
|
|
<iframe
|
|
src="https://www.youtube-nocookie.com/embed/codAs9-NeHM"
|
|
frameBorder="1"
|
|
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
|
|
allowFullScreen
|
|
></iframe>
|
|
</div>
|
|
|
|
## Creating a webhook
|
|
|
|
1. Create a new [Database Webhook](https://supabase.com/dashboard/project/_/database/hooks) in the Dashboard.
|
|
1. Give your Webhook a name.
|
|
1. Select the table you want to hook into.
|
|
1. Select one or more events (table inserts, updates, or deletes) you want to hook into.
|
|
|
|
Since webhooks are just database triggers, you can also create one from SQL statement directly.
|
|
|
|
```sql
|
|
create trigger "my_webhook" after insert
|
|
on "public"."my_table" for each row
|
|
execute function "supabase_functions"."http_request"(
|
|
'http://localhost:3000',
|
|
'POST',
|
|
'{"Content-Type":"application/json"}',
|
|
'{}',
|
|
'1000'
|
|
);
|
|
```
|
|
|
|
We currently support HTTP webhooks. These can be sent as `POST` or `GET` requests with a JSON payload.
|
|
|
|
## Payload
|
|
|
|
The payload is automatically generated from the underlying table record:
|
|
|
|
```typescript
|
|
type InsertPayload = {
|
|
type: 'INSERT'
|
|
table: string
|
|
schema: string
|
|
record: TableRecord<T>
|
|
old_record: null
|
|
}
|
|
type UpdatePayload = {
|
|
type: 'UPDATE'
|
|
table: string
|
|
schema: string
|
|
record: TableRecord<T>
|
|
old_record: TableRecord<T>
|
|
}
|
|
type DeletePayload = {
|
|
type: 'DELETE'
|
|
table: string
|
|
schema: string
|
|
record: null
|
|
old_record: TableRecord<T>
|
|
}
|
|
```
|
|
|
|
## Monitoring
|
|
|
|
Logging history of webhook calls is available under the `net` schema of your database. For more info, see the [GitHub Repo](https://github.com/supabase/pg_net).
|
|
|
|
## Resources
|
|
|
|
- [pg_net](/docs/guides/database/extensions/pgnet): an async networking extension for PostgreSQL
|