App Event Subscription is created whenever an App Event is used in a Flow Instance.

Global Webhook

If you use Global Webhook for your App Events, you need to make this request to trigger relevant flows:

curl --request POST \
	--url https://api.integration.app/{GLOBAL_WEBHOOK_URI} \
	--header "Authorization: Bearer {CUSTOMER_TOKEN}" \
	--header "Content-Type: application/json" \
	--data {}

Per-user Subscriptions

If you use per-user subscriptions, flow instances will be triggered automatically when an event happens.

You can explore the user subscriptions here: App Event Subscriptions.

Monitoring Events

You can monitor events and flow instances they launch on the App Events page.

Troubleshooting App Webhooks

Here is a list of common issues and how you can troubleshoot them.

Flow was not launched

If you expected a webhook to launch a flow, but it didn't, do the following steps:

Step 1: Check Logs

Go to the Webhook Logs and check if the events you expected are there.
Use filters to narrow down the list.

If you didn't find the event you were looking for, check the next section ("Webhook events do not appear in logs").

If you found the record you were looking for in the logs, check out its details:

• Is it associated to the correct App User?
• Does it have the data you expected?

Step 2: Check Flow Node Configuration

If you found the event in logs, but it didn't trigger the flow you expected, check the node configuration:

• Does it use the right webhook? You can see it in the node dependencies on the Flow Instance page.
• Does it have a filter that excludes the event you found?

If you found the event, checked the node configuration, but still cannot find the problem – please reach out to [email protected].

Webhook events do not appear in logs

If you expected a webhook event to appear in the platform, but it didn't – here is what you could try to do:

Step 1: Check Subscription

If you are using a webhook with subscription, find the subscription by Webhook and User, and check its status.
Is it subscribed successfully?

Skip this step if you don't use a subscription.

Step 2: Trigger the webhook manually

Make an HTTP request to the webhook URL:

• If using a subscription – find the webhook URL on the corresponding subscription page.
• If not – use the URL from the webhook page.

Did the request succeed?

If the request succeeded, but you still don't see the event in logs – please reach out to [email protected].

Webhook subscription is not created

If you expect a webhook subscription to be created, but it was not – find it on the Subscriptions page and check the latest request and response. Do they look correct?

If everything looks good in the request and the response – the problem is likely on your app's side – it didn't create the subscriptions.

You can try deleting the subscription and creating it again to troubleshoot.