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

# Create an Integration

> Set up webhook integrations in JourneyBee

Create webhook integrations in the JourneyBee dashboard to receive real-time event notifications.

## Setup Steps

1. Navigate to **Settings** → **Developed Integrations** in JourneyBee
2. Click **Create New Integration**
3. Configure your integration details
4. Get your **Integration UUID** (use as JWT secret)
5. Set your webhook endpoint URL
   <img src="https://mintcdn.com/journeybee/TKtJH_BJdRMo6_pZ/create-integration.jpeg?fit=max&auto=format&n=TKtJH_BJdRMo6_pZ&q=85&s=9dde95fa8c4d475603f5e1745f7582ab" alt="Create integration page showing the form to set up a new webhook integration" className="rounded-lg" width="2540" height="1395" data-path="create-integration.jpeg" />

## Integration Configuration

### Basic Settings

<ParamField body="label" type="string" required>
  Integration name (e.g., "CRM Sync")
</ParamField>

<ParamField body="webhook_url" type="string" required>
  HTTPS endpoint URL for receiving webhooks
</ParamField>

<ParamField body="integration_uuid" type="string">
  Generated UUID for JWT verification (copy and store securely)
</ParamField>

### Event Subscriptions

Select which events to receive:

#### Partner Events

* `partner_created`
* `partner_updated`
* `partner_contact_created`
* `partner_contact_updated`

#### Lead Events

* `lead_created`
* `lead_updated`
* `lead_deleted`
* `lead_note_created`
* `lead_note_updated`
* `lead_note_deleted`

#### Deal Events

* `deal_created`
* `deal_updated`
* `deal_deleted`
* `deal_note_created`
* `deal_note_updated`
* `deal_note_deleted`

#### Message Events

* `message_created`
* `message_updated`
* `message_deleted`

## Testing Your Integration

Use the **Send Test Webhook** button to verify your endpoint:

1. Select an event type
2. Check your endpoint receives the payload
3. Verify JWT token verification works
4. Confirm 200 OK response

## Integration Management

### View Integration

```http theme={null}
GET /api/v1/integrations/{integration_id}
```

### Update Settings

```http theme={null}
PATCH /api/v1/integrations/{integration_id}
```

### Pause/Resume

```http theme={null}
POST /api/v1/integrations/{integration_id}/pause
POST /api/v1/integrations/{integration_id}/resume
```

## Requirements

* HTTPS endpoint only
* Respond with 200 OK within 10 seconds
* Handle duplicate events with idempotency
* Verify JWT tokens using Integration UUID

## Next Steps

* **[Authentication](/webhooks/authentication)** - Implement JWT verification
* **[Webhook Events](/webhooks/events/deal_created)** - See all available events