Webhooks

Webhooks are automated messages sent from one app to another when a specific event occurs. In Tiled, webhooks notify a third-party endpoint each time a microapp triggers a completion event, allowing external systems to react automatically.

In Tiled, the completion events system lets builders configure a webhook URL on each microapp. Each time the microapp triggers a completion event, Tiled sends an HTTP POST request to that webhook URL.

You must also set up a receiving endpoint at that URL. The endpoint must accept the incoming POST request and use the payload data to perform the actions you want — for example, sending a Slack notification, updating a database record, or logging a custom analytics event.

Some example use cases:

• Send a notification via slack, email, etc
• Update an internal database
• Fire off custom analytics or tracking events

For anyone curious about what kind of data will be sent out by Tiled's webhook system, here is an example of the payload to expect on your end when building an endpoint to handle incoming webhook requests.

Example webhook payload:

{
  "userId": "example@recipient.com",
  "microappId": "5ca668834b320d1f53dc7bab",
  "microappName": "Test microapp",
  "completionName": "cmptscreen5cca158fa969a00eee04ba12"
 }

Create a webhook for your project at https://webhook.site/