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

# Webhooks

> Integrate Extrovert with external systems through webhooks

## Overview

Webhooks allow you to automatically push prospects to external systems like sequencing tools when specific conditions are met. This enables seamless integration between Extrovert and your existing sales and marketing stack.

## How It Works

When you configure a webhook in Extrovert:

1. You define trigger conditions (e.g., when a prospect receives a certain number of comments)
2. Extrovert monitors your campaigns for these conditions
3. When conditions are met, Extrovert sends an HTTP request to your specified endpoint
4. Your external system receives the prospect data and can process it accordingly

## Setting Up Webhooks

### Step 1: Navigate to Webhooks

1. Log in to your Extrovert dashboard
2. Go to **Integrations** from the sidebar menu
3. Click on the **Webhooks** tab
4. Click the **Add webhook** button

### Step 2: Configure Your Webhook

#### Basic Information

* **Name**: Give your webhook a descriptive name to identify it easily

#### Conditions

Define when the webhook should be triggered:

* **Comment Threshold**: Set the number of comments on a prospect that triggers the webhook
  * Example: "You commented on the prospect more than X times"
  * Replace X with your desired number (e.g., 3, 5, 10)

#### Campaign Selection

* **Campaigns**: Select which campaigns this webhook should monitor
  * You can select multiple campaigns
  * The webhook will only trigger for prospects in the selected campaigns

### Step 3: Configure Webhook Parameters

#### Request Configuration

* **Request Method**: Choose the HTTP method for your webhook
  * POST (recommended for sending data)
  * GET

* **URL**: Enter the endpoint URL where the webhook should send data
  * You can use the `{{linkedinUrl}}` variable in the URL
  * Example: `https://your-api.com/prospects?linkedin={{linkedinUrl}}`

* **Body**: Configure the request body (for POST, PUT, PATCH methods)
  * Must be valid JSON format
  * You can use the `{{linkedinUrl}}` variable in the body
  * Example:
    ```json theme={null}
    {
      "prospect_linkedin": "{{linkedinUrl}}",
      "source": "extrovert",
      "campaign_name": "your_campaign"
    }
    ```

#### Authentication

Choose how to authenticate your webhook requests:

1. **No Authentication**: No authentication headers will be sent
2. **Custom Header**: Add a custom authentication header
   * **Auth Header Name**: The name of your authentication header (e.g., "Authorization", "X-API-Key")
   * **Auth Header Value**: The value for your authentication header (e.g., "Bearer your-token", "your-api-key")

### Step 4: Save and Test

1. Click **Save** to create your webhook
2. The webhook will immediately start monitoring your selected campaigns
3. Test your webhook by ensuring a prospect meets the trigger conditions

## Available Variables

Currently, the following variable is available for use in webhook URLs and bodies:

* `{{linkedinUrl}}`: The LinkedIn profile URL of the prospect

## Use Cases

### 1. Push to Sequencing Tools

Automatically add qualified prospects to your email sequencing tool when they've shown engagement through multiple LinkedIn comments.

### 2. CRM Integration

Send prospect data to your CRM when they reach a certain engagement threshold.

### 3. Analytics and Reporting

Send engagement data to your analytics platform for advanced reporting.

## Troubleshooting

### Webhook Not Triggering

* Verify the trigger conditions are being met
* Check that the webhook is enabled
* Ensure the selected campaigns are active

### Authentication Failures

* Double-check your authentication header name and value
* Ensure your API key or token is valid and not expired

### Invalid JSON Errors

* Validate your request body using a JSON validator
* Ensure all strings are properly quoted
* Check that the `{{linkedinUrl}}` variable is properly placed within quotes

## Need Help?

If you encounter any issues or need assistance setting up webhooks, please contact our support team at [support@goextrovert.com](mailto:support@goextrovert.com).