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

# Webhooks overview

> Real-time notifications for events in your Partnero programs

Webhooks enable real-time communication between Partnero and your systems. There are two types:

<CardGroup cols={2}>
  <Card title="Outgoing Webhooks" icon="arrow-right-from-bracket" href="/guides/webhooks/outgoing-webhooks">
    Receive notifications when events occur in Partnero (partner sign-ups, transactions, etc.)
  </Card>

  <Card title="Incoming Webhooks" icon="arrow-right-to-bracket" href="/guides/webhooks/incoming-webhooks">
    Send data to Partnero from external services (payment processors, CRMs, etc.)
  </Card>
</CardGroup>

## When to Use Each Type

### Outgoing Webhooks

Use outgoing webhooks when you want to **react to events** in Partnero:

* Send welcome emails when partners sign up
* Update your CRM when customers are created
* Sync commission data to your accounting system
* Trigger workflows in Zapier or Make

### Incoming Webhooks

Use incoming webhooks to **send data** to Partnero:

* Track payments from custom payment processors
* Sync customer data from external systems
* Create transactions from third-party platforms
* Integrate with services without native Partnero support

## Quick Comparison

| Feature            | Outgoing Webhooks               | Incoming Webhooks           |
| ------------------ | ------------------------------- | --------------------------- |
| **Direction**      | Partnero → Your server          | External service → Partnero |
| **Trigger**        | Events in Partnero              | External events             |
| **Setup**          | Configure in Partnero dashboard | Use Partnero webhook URLs   |
| **Authentication** | Signature verification          | API key or program ID       |
| **Use case**       | React to Partnero events        | Send data to Partnero       |

## Getting Started

<Steps>
  <Step title="Choose your webhook type">
    Determine whether you need to receive events (outgoing) or send data (incoming).
  </Step>

  <Step title="Set up your endpoint">
    For outgoing webhooks, create an HTTPS endpoint on your server.
    For incoming webhooks, get your unique webhook URL from Partnero.
  </Step>

  <Step title="Configure and test">
    Set up your webhook in the Partnero dashboard and test with sample events.
  </Step>
</Steps>