# Set up webhooks for developers

> Receive Bridge events in your own service

- Type: Task
- App: Admin console
- Screen: Webhooks
- Section: HubSpot integration
- Also searched as: webhooks, developers, api, callback url, api key, client secret, hmac, signature, events, automations, custom integration, test
- Open: https://help.bridge.new/console/hubspot-webhooks?lang=en
- Markdown: https://help.bridge.new/md/console/hubspot-webhooks.md

Receive Bridge events in your own service

In Developers › Webhooks you register your endpoint, protect every delivery with an HMAC signature and choose the events for your automations. In 9 steps.

## What you can do

- Your endpoint in Callback URL
- HMAC signature with Client Secret
- CRM and custom features
- Testing with Test

## Steps

### Step 1 · Open Developers › Webhooks

Webhooks are set up in the Developers section.

Webhooks extend the integration with custom automations and are meant for developers and technical administrators. In the Bridge admin console, open Developers › Webhooks in the sidebar.

- Developers › Webhooks
- For developers and technical administrators

Open: https://help.bridge.new/console/hubspot-webhooks/1?lang=en

### Step 2 · Enter the Callback URL

Bridge sends the events to your endpoint.

In Callback URL, enter the endpoint that will receive the webhook events, for example https://your-service.example.com/webhook. It is a required field.

- The endpoint that receives the events
- Required field

Open: https://help.bridge.new/console/hubspot-webhooks/2?lang=en

### Step 3 · Enter the Bridge-API-Key

The API key authenticates the subscription.

In Bridge-API-Key, enter the API key. It is the authentication header used to authenticate webhook subscription requests. It is a required field.

- Authentication header
- Authenticates subscription requests
- Required field

Open: https://help.bridge.new/console/hubspot-webhooks/3?lang=en

### Step 4 · Enter the Client Secret

The secret protects every delivery.

In Client Secret, enter the secret used to create an HMAC signature (hash-based message authentication code). The signature verifies the integrity of each webhook payload and prevents spoofing. It is a required field.

- Creates the HMAC signature
- Verifies integrity and prevents spoofing
- Required field

Open: https://help.bridge.new/console/hubspot-webhooks/4?lang=en

### Step 5 · Verify the signature at your endpoint

Your service checks that the event comes from Bridge.

Every webhook payload is signed with HMAC using the Client Secret. Your endpoint should verify the signature before processing the payload, to make sure it came from Bridge.

- Every payload is signed with HMAC
- Verify the signature before processing

Open: https://help.bridge.new/console/hubspot-webhooks/5?lang=en

### Step 6 · Verify and save

Save the webhook settings.

With the three fields filled in, click Verify and save.

- Fill in the three fields
- Click Verify and save

Open: https://help.bridge.new/console/hubspot-webhooks/6?lang=en

### Step 7 · Review CRM Connected Features

Some features are already reported with the CRM connected.

CRM Connected Features lists the features that are reported automatically when a CRM is connected, such as Contact Updates. You can also configure them for a custom webhook if you need to route them elsewhere.

- Reported with the CRM connected
- Contact Updates
- Configurable for a custom webhook

Open: https://help.bridge.new/console/hubspot-webhooks/7?lang=en

### Step 8 · Choose Custom Integration Features

Other features are turned on as you need them.

Custom Integration Features are opt-in webhooks for building automations on specific event types, all in version V1. Task Notifications fires when a task is created, updated or completed; Call Notifications, when a call is logged in Bridge; Meeting Notifications, when a meeting is created or updated; Email Notifications, when an email activity is tracked; and Conversation Summary Notifications, when a daily AI-generated conversation summary is created.

- Opt-in webhooks, version V1
- Tasks, calls, meetings, emails and summaries

Open: https://help.bridge.new/console/hubspot-webhooks/8?lang=en

### Step 9 · Test each feature with Test

Check the integration before you rely on it.

Each configured feature has a Test button in the Webhooks screen. Use it to send a sample payload to your endpoint and check that your integration works correctly. If you need help, contact support at support@sainapsis.com.

- Click Test
- Your endpoint gets a sample payload
- Check that the integration works

Open: https://help.bridge.new/console/hubspot-webhooks/9?lang=en

## Related guides

- Tour of this screen: [Get to know the HubSpot integration](https://help.bridge.new/md/console/hubspot.md): What the HubSpot integration does and how it works day to day. · Open: https://help.bridge.new/console/hubspot?lang=en
- More in HubSpot integration: [Connect HubSpot from Bridge](https://help.bridge.new/md/console/hubspot-connect.md): Connect your HubSpot portal from the Bridge console · Open: https://help.bridge.new/console/hubspot-connect?lang=en
- More in HubSpot integration: [Install Bridge from the HubSpot Marketplace](https://help.bridge.new/md/console/hubspot-marketplace.md): Install Bridge in your portal from the HubSpot App Marketplace · Open: https://help.bridge.new/console/hubspot-marketplace?lang=en
- More in HubSpot integration: [Choose the sync and map the fields](https://help.bridge.new/md/console/hubspot-mapping.md): Decide how contacts come in and match HubSpot fields with Bridge · Open: https://help.bridge.new/console/hubspot-mapping?lang=en
- More in HubSpot integration: [Review the HubSpot sync](https://help.bridge.new/md/console/hubspot-overview.md): Check in Overview how the sync between HubSpot and Bridge is going · Open: https://help.bridge.new/console/hubspot-overview?lang=en
- More in HubSpot integration: [Choose which activities are sent to HubSpot](https://help.bridge.new/md/console/hubspot-activities.md): Decide which Bridge activity is logged in HubSpot · Open: https://help.bridge.new/console/hubspot-activities?lang=en
- More in HubSpot integration: [Control contact and deal fields](https://help.bridge.new/md/console/hubspot-fields.md): Decide which HubSpot fields are shown and edited in Bridge · Open: https://help.bridge.new/console/hubspot-fields?lang=en
- More in HubSpot integration: [Release conversations by deal stage](https://help.bridge.new/md/console/hubspot-pipelines.md): Release conversations when a HubSpot deal reaches a stage · Open: https://help.bridge.new/console/hubspot-pipelines?lang=en
- More in HubSpot integration: [Handle duplicate contacts with HubSpot](https://help.bridge.new/md/console/hubspot-duplicates.md): Detect and resolve duplicate contacts between HubSpot and Bridge · Open: https://help.bridge.new/console/hubspot-duplicates?lang=en
- More in HubSpot integration: [Disconnect or uninstall HubSpot](https://help.bridge.new/md/console/hubspot-disconnect.md): Stop the HubSpot integration without losing data · Open: https://help.bridge.new/console/hubspot-disconnect?lang=en
