Webhook sources let your applications push webhook events into Materialize. This quickstart uses an embedded webhook event generator that makes it easier for you to learn and prototype with no external dependencies.
Before you begin
All you need is a Materialize account. If you already have one — great! If not, sign up for a playground account first.
When you’re ready, head over to the Materialize console, and pop open the SQL Shell.
Step 1. Create a secret
To validate requests between the webhook event generator and Materialize, you need a secret:
CREATE SECRET demo_webhook AS '<secret_value>';
<secret_value> to a unique value that only you know and store it in
a secure location.
Step 2. Set up a webhook source
Using the secret from Step 1., create a webhook source to ingest data from the webhook event generator:
CREATE SOURCE webhook_demo IN CLUSTER my_cluster FROM WEBHOOK
BODY FORMAT JSON
BODY AS request_body,
After a successful run, the command returns a
NOTICE message containing the
unique webhook URL
that allows you to
POST events to the source. Copy and store it. You will need
it for the next step.
Step 3. Generate webhook events
To get started with your own data, check out the reference documentation for the webhook source.