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

# Webhook Endpoints: Inventory Sync and Inbound Email

> Site Store Pro webhook reference for inventory sync, inbound email, Stripe, and Paddle. All routes are CSRF-exempt. Covers auth, payloads, and provider config.

Site Store Pro exposes webhook endpoints for external integrations. All webhook routes are **CSRF-exempt** — they do not require a CSRF token and can be called directly from external services.

***

## Overview

| Endpoint | Purpose |
| - | - |
| `POST /webhooks/inventory-update` | Automated inventory sync from external WMS or ERP |
| `POST /webhooks/inbound-email` | Inbound email-to-ticket ingestion |
| `POST /webhooks/stripe` | Stripe payment event processing |
| `POST /webhooks/paddle` | Paddle payment event processing |

***

## Inventory Update Webhook

**Endpoint:** `POST /webhooks/inventory-update`

Allows external warehouse management systems (WMS), ERP platforms, or custom scripts to push inventory level updates to Site Store Pro without requiring an admin login.

### Authentication

The webhook verifies the request using a shared secret. Include your secret using **any one** of the following methods:

```bash Custom Header theme={null}
curl -X POST https://yourdomain.com/webhooks/inventory-update \
  -H "X-Inventory-Webhook-Token: your-secret-here" \
  -H "Content-Type: application/json" \
  -d '{"sku": "SKU-AAA-123", "stock_level": 150}'
```

```bash Bearer Token theme={null}
curl -X POST https://yourdomain.com/webhooks/inventory-update \
  -H "Authorization: Bearer your-secret-here" \
  -H "Content-Type: application/json" \
  -d '{"sku": "SKU-AAA-123", "stock_level": 150}'
```

```bash Query Parameter theme={null}
curl -X POST "https://yourdomain.com/webhooks/inventory-update?api_token=your-secret-here" \
  -H "Content-Type: application/json" \
  -d '{"sku": "SKU-AAA-123", "stock_level": 150}'
```

### Setting Your Secret

Add your chosen secret to `.env`:

```ini theme={null}
INVENTORY_WEBHOOK_SECRET=your-secret-here
```

> [!WARNING]
>
> Requests with a missing or invalid secret are rejected with a `401 Unauthorized` response. Set a long, randomly generated string as your secret.

### Request Payload

```json theme={null}
{
  "sku": "SKU-AAA-123",
  "stock_level": 150,
  "warehouse_level": 80,
  "use_warehouse_stock": true,
  "location_id": 2
}
```

| Field | Type | Required | Description |
| - | - | - | - |
| `sku` | string | **Yes** | The product variant SKU to update |
| `stock_level` | integer | No | New total stock level |
| `warehouse_level` | integer | No | Stock level at the specified warehouse location |
| `use_warehouse_stock` | boolean | No | Whether to use `warehouse_level` as the active stock source |
| `location_id` | integer | No | Warehouse/location ID (if using multi-location inventory) |

> [!NOTE]
>
> All fields except `sku` are optional. Any field that is omitted is left unchanged — only explicitly provided fields are updated.

### Response

A successful update returns a `200 OK` response with a JSON body containing the updated inventory record and the new calculated total stock.

```json theme={null}
{
  "success": true,
  "sku": "SKU-AAA-123",
  "stock_level": 150,
  "warehouse_level": 80,
  "calculated_total": 150
}
```

***

## Inbound Email Webhook

**Endpoint:** `POST /webhooks/inbound-email`

Enables customers and staff to reply to support tickets by simply replying to a notification email — without logging into the dashboard.

### How It Works

Every ticket notification email is sent with a unique reply-to address:

```text theme={null}
reply+{token}@yourdomain.com
```

When a recipient replies, the email provider routes the message to this webhook. Site Store Pro then:

1. Extracts the `{token}` from the recipient address
2. Verifies the token against the `tickets` table
3. Appends the email body as a new reply on the matched ticket thread

### Supported Email Providers

> [card] Cloudflare Email Workers
>
> Configure Cloudflare Email Routing rules to forward `reply+*@yourdomain.com` addresses to your webhook endpoint via an Email Worker.

> [card] Mailgun
>
> Set up a Mailgun inbound routing rule to `POST` the parsed email payload to `https://yourdomain.com/webhooks/inbound-email`.

> [card] Postmark
>
> Use Postmark's inbound email processing to forward structured JSON email payloads to your webhook endpoint.

> [!TIP]
>
> Add a DNS catch-all or wildcard MX record for `reply+*@yourdomain.com` so all tokenized reply addresses are routed to your configured email provider.

***

## Stripe Webhook

**Endpoint:** `POST /webhooks/stripe`

Handles Stripe payment events including successful charges, failed payments, refunds, and subscription updates.

See the [Stripe payment processor documentation](https://docs.sitestorepro.com/payments/stripe.md) for webhook registration instructions and a full list of handled events.

***

## Paddle Webhook

**Endpoint:** `POST /webhooks/paddle`

Handles Paddle payment events for order fulfillment and subscription management.

See the [Paddle payment processor documentation](https://docs.sitestorepro.com/payments/paddle.md) for webhook registration instructions and event handling details.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.