Setup Two-way sync with Webhooks

What are Webhooks?

Webhooks allow Pluggy to notify your application of events without requiring you to request updates, keeping you up to date with the latest changes to your created items.

Configuring Webhooks

You can set up Webhooks in two ways:

  • Using Pluggy's Dashboard: Go to Applications, then click on the "Edit" icon for your application. Scroll down to the "Webhooks" section, where you can register new webhooks and view, edit, or delete existing ones.
  • Using our API directly: Set up specific notification URLs for each particular event or set up a single listening point for all events using an HTTP client such as Postman.

Please refer to our Webhooks Guide for more information about setting up Webhooks, payloads, event types, and available requests.

Receiving Notifications

Once you have configured the webhooks, validate that all event types are being received as expected. It's important to have successfully validated that each event has been received.

To test this, you can use tools like requestcatcher.com to confirm that notifications are correctly being sent.

Respond with a 2xx status code quickly

To acknowledge the reception of the notification event, your endpoint must return a 2xx HTTP code to Pluggy. If Pluggy receives any other status code, it will indicate that you did not receive the event.

If Pluggy does not receive a successful response, the event notification will be retried. After multiple failures to send the event, we will mark the notification as failed and the notification will be lost.

⚠️ Since it's very important to confirm the event reception, your endpoint should return a success response before doing any business logic that could result in an error.