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

# Set Up Webhook Endpoints

> Configure webhook URLs, authentication headers, and event types through the dashboard or API.

Point Dasha BlackBox at your endpoint, add authentication headers, and receive HTTP POST requests for call events.

**What you'll learn:** Dashboard and API configuration, URL requirements.

***

## Quick setup

<Steps>
  <Step title="Navigate to webhooks">
    Agent → **Settings** → **Webhooks**
  </Step>

  <Step title="Enter URL">
    Must be HTTPS and publicly accessible
  </Step>

  <Step title="Add headers">
    Bearer tokens, API keys for authentication
  </Step>

  <Step title="Test">
    Use the test button to verify HTTP 200 response
  </Step>
</Steps>

***

## URL requirements

* **HTTPS recommended** — Use HTTPS for security
* **Publicly accessible** — No localhost or private IPs
* **Response under 10 seconds** — Use async processing

For local development, use [ngrok](https://ngrok.com):

<Accordion title="Example: Local development with ngrok">
  ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
  ngrok http 3000
  # Use https://xxx.ngrok.io/webhook
  ```
</Accordion>

***

## Response requirements

| Status  | Meaning      | Retry? |
| ------- | ------------ | ------ |
| 2xx     | Success      | No     |
| 4xx     | Client error | No     |
| 5xx     | Server error | Yes    |
| Timeout | No response  | Yes    |

**Best practice**: Respond immediately, process asynchronously.

***

## Checklist

* [ ] URL publicly accessible
* [ ] Response time under 10 seconds
* [ ] Idempotency handling implemented

***

## What's next

<CardGroup cols={2}>
  <Card title="Webhook Events" icon="bell" href="/docs/webhooks-and-events/webhook-events">
    Event types and payloads
  </Card>

  <Card title="Testing Webhooks" icon="flask-vial" href="/docs/webhooks-and-events/testing-webhooks">
    Comprehensive testing guide
  </Card>
</CardGroup>