---
agentTools:
  projectIndex: https://docs.bond.tech/llms.txt
---

# Webhooks

What can you do on the Bond Portal **Webhooks** page.

# Overview

A <<glossary:Webhook>> is a way to enable server-to-server communication. Webhooks are asynchronous by nature and facilitate communication between two different software systems, allowing each system to push state/status changes from one system to the other. Webhooks are essential for keeping your system up to date with the latest status/events from the Bond platform. At Bond, these include events such as when your customer’s bank confirms a payment, when a customer disputes a charge, or when a recurring payment succeeds.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/a9739dd-13-webhooks.png",
        "13-webhooks.png",
        1600,
        900,
        "#dedde4"
      ]
    }
  ]
}
[/block]

The following is an overview of how to set up Webhooks:

1. Get the webhook URL from the application you want to send data to.
2. Use that URL in the webhook section of the application you want to receive data from.
3. Subscribe to the types of events you want the application to notify you about.

For more details, see:

* <a href="doc:event-subscriptions" target="_blank">Webhook events and subscriptions</a>
* <a href="doc:testing-webhooks" target="_blank">Testing webhooks</a>
* <a href="ref:webhooks" target="_blank">Webhooks</a>

# What can you do on the **Webhooks** page

On this page you can:

* Manage existing webhooks and view their details
* Add webhooks

## Displaying webhook details

1. Click on the webhook you want to examine.
   The details pane for the webhook is displayed on the right.
2. Click on Expand (chevron) to expand the required section, for example **Card** or **KYC**.
   The relevant section is expanded as shown in the following graphic.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/4a70296-14-webhook_details.png",
        "14-webhook details.png",
        1600,
        900,
        "#c8c8d1"
      ]
    }
  ]
}
[/block]

## Creating a webhook

1. Click **Create Webhook**.
   The **Create Webhook** popup is displayed.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/bd89f2e-15-webhook_create.png",
        "15-webhook create.png",
        1600,
        900,
        "#9f9fad"
      ]
    }
  ]
}
[/block]

2. In the **URL to send data to** field, enter the URL for the webhook.
3. In the **Description** field, enter a descriptive name for the webhook.
4. Under **Events**, check the required event(s) for which to create a webhook.
5. Click **Save** to save the new webhook, or click **Cancel** to cancel the process.
   The new webhook is displayed in the list.

## Editing an existing webhook

1. Click on the webhook you want to edit.
   The details pane for the selected webhook is displayed on the right.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/ac78e3a-16-webhook_edit.png",
        "16-webhook edit.png",
        1600,
        900,
        "#c8c8d1"
      ]
    }
  ]
}
[/block]

2. Edit the required details, such as **URL** or **Events**.
3. Click **Save**.