> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bridge.new/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

# Console Configuration

You can manage all webhook settings directly from the [Bridge Admin Console](https://admin.bridge.new).\
This includes defining your webhook endpoint, authentication keys, and selecting which event types to subscribe to.

***

## Setting Up Webhooks

Follow these steps to configure your webhook in the Bridge Admin Console:

1. **Log in** to your Bridge Admin Console.
2. Navigate to **Developers → Webhooks**.
3. Provide the following details:
   * **Webhook URL:** The full HTTPS URL of your endpoint.
   * **API Key:** Used for identifying your workspace.
   * **Client Secret:** Used to generate and verify webhook signatures (HMAC-SHA256).
4. **Select Event Types** you want to subscribe to.

***

## CRM Integration Behavior

When you have a CRM system connected to your Bridge workspace, **CRM updates happen automatically**:

### Automatic CRM Updates

* **CRM-connected features** are **automatically reported** to your CRM system
* Your CRM is **automatically updated** with new data without any additional configuration
* This happens in real-time as events occur in your Bridge workspace

### Custom Webhooks (Optional)

* **Custom webhooks** are **optional** and provide additional processing capabilities
* You can configure custom webhooks for the same events that are already being sent to your CRM
* This allows you to:
  * Send data to additional systems beyond your CRM
  * Apply custom business logic or transformations
  * Integrate with other third-party services

### Dual Data Flow

```mermaid theme={null}
flowchart LR
    A[Bridge Event] -->|Automatic Updates| B[CRM System]
    A -->|Your Processing| C[Custom Webhook]

    style A fill:#e3f2fd,stroke:#1976d2,stroke-width:3px
    style B fill:#e8f5e8,stroke:#388e3c,stroke-width:2px
    style C fill:#fff3e0,stroke:#f57c00,stroke-width:2px
```

### Key Points

* **CRM updates are automatic** - no configuration needed
* **Custom webhooks are optional** - only configure if you need additional processing
* **Both can work together** - CRM gets updated automatically while custom webhooks provide additional flexibility
* **No duplication** - the same event can update your CRM and trigger your custom webhook

### CRM Provider Detection

The console automatically detects your connected CRM provider and shows which features are already being reported. You can:

* View which events are currently sent to your CRM automatically
* Configure additional webhook endpoints for the same events (optional)
* Customize event versions and processing logic for custom webhooks

***

## Event Subscription Options

Bridge currently supports the following event categories:

### Conversation Summary Notifications

<button type="button" style={{ display: "inline-block", padding: "3px 12px", borderRadius: "999px", background: "#3b82f6", color: "white", fontSize: "0.7rem", fontWeight: 600, letterSpacing: "0.05em", border: "none", cursor: "pointer", marginTop: "-0.5rem" }}>v1</button>

Receive a notification once per day, per conversation, when Bridge AI generates the daily summary.

* `conversation_summary.created`

### Tasks Notifications

<button type="button" style={{ display: "inline-block", padding: "3px 12px", borderRadius: "999px", background: "#3b82f6", color: "white", fontSize: "0.7rem", fontWeight: 600, letterSpacing: "0.05em", border: "none", cursor: "pointer", marginTop: "-0.5rem" }}>v1</button>

Receive notifications when tasks are created or their state changes.

* `task.created`
* `task.status_changed`
* `task.assigned`
* `task.unassigned`
* `task.remove_reminder`
* `task.field_updated`

### Contact Updates

<button type="button" style={{ display: "inline-block", padding: "3px 12px", borderRadius: "999px", background: "#3b82f6", color: "white", fontSize: "0.7rem", fontWeight: 600, letterSpacing: "0.05em", border: "none", cursor: "pointer", marginTop: "-0.5rem" }}>v1</button>

Receive notifications when contacts are created, updated, or deleted.

* `contact.created`
* `contact.updated`
* `contact.deleted`

### Call Notifications

<button type="button" style={{ display: "inline-block", padding: "3px 12px", borderRadius: "999px", background: "#3b82f6", color: "white", fontSize: "0.7rem", fontWeight: 600, letterSpacing: "0.05em", border: "none", cursor: "pointer", marginTop: "-0.5rem" }}>v1</button>

Receive a single webhook for each lifecycle phase of a call (created, ringing, started, finished) plus the AI transcript once it is ready. Calls are not deleted.

* `call.created`
* `call.updated`
* `call.transcription.created`

### Meeting Notifications

<button type="button" style={{ display: "inline-block", padding: "3px 12px", borderRadius: "999px", background: "#3b82f6", color: "white", fontSize: "0.7rem", fontWeight: 600, letterSpacing: "0.05em", border: "none", cursor: "pointer", marginTop: "-0.5rem" }}>v1</button>

Receive a notification when a meeting reaches the CREATED state. Meetings are not deleted, so only the `meeting.updated` event is emitted.

* `meeting.updated`

### Email Notifications

<button type="button" style={{ display: "inline-block", padding: "3px 12px", borderRadius: "999px", background: "#3b82f6", color: "white", fontSize: "0.7rem", fontWeight: 600, letterSpacing: "0.05em", border: "none", cursor: "pointer", marginTop: "-0.5rem" }}>v1</button>

Receive a notification once an email has been processed and the AI summary is available. Emails are not deleted, so only the `email.updated` event is emitted.

* `email.updated`

***

## Verifying Your Configuration

Once you save your webhook configuration, Bridge automatically sends a **test webhook** to your endpoint to ensure it is reachable and correctly responding.

Your endpoint must respond with:

* **HTTP Status Code:** `200–299`
* **Content-Type:** `application/json` (optional)
* **Response Time:** under **30 seconds**

***

## Managing Webhooks

You can manage your webhook configuration anytime from the console:

| Action             | Description                                                         |
| ------------------ | ------------------------------------------------------------------- |
| **Edit**           | Update the URL, API key, or subscribed events                       |
| **Disable Events** | Temporarily pause specific event types without deleting the webhook |
| **Delete**         | Permanently remove a webhook configuration                          |

***

## Related Topics

* [Overview](/webhooks)
* [Verifying Signatures](/webhooks/verifying-signatures)
* [Event Types](/webhooks/events)
