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

# Webhooks

> Receive real-time notifications when events happen in your OutX account

<Note>
  **Webhooks are coming soon.** This feature is currently under development and not yet available. Sign up below to be notified when webhooks launch.
</Note>

## Overview

Webhooks will allow you to receive real-time HTTP callbacks when events occur in your OutX account, eliminating the need to poll the API for updates.

## Planned Event Types

| Event                     | Description                                                             |
| ------------------------- | ----------------------------------------------------------------------- |
| `watchlist.post.detected` | A new post matching your keyword, people, or company watchlist is found |
| `engagement.completed`    | An auto-engagement action (like or comment) has been executed           |
| `engagement.failed`       | An engagement action failed to complete                                 |
| `task.completed`          | An async task (profile fetch, data export, etc.) has finished           |
| `task.failed`             | An async task encountered an error                                      |
| `watchlist.created`       | A new watchlist was created                                             |
| `watchlist.deleted`       | A watchlist was removed                                                 |

## Payload Format Preview

```json theme={null}
{
  "id": "evt_abc123",
  "type": "watchlist.post.detected",
  "created_at": "2026-03-08T12:00:00Z",
  "data": {
    "watchlist_id": "wl_xyz789",
    "watchlist_type": "keyword",
    "post": {
      "id": "post_456",
      "author": "Jane Doe",
      "content": "Excited to announce our new product launch...",
      "url": "https://linkedin.com/feed/update/urn:li:activity:123456",
      "detected_at": "2026-03-08T12:00:00Z"
    }
  }
}
```

## Get Notified When Webhooks Launch

Interested in using webhooks? Reach out and we will add you to the early access list.

<Card title="Request Early Access" icon="envelope" href="mailto:support@outx.ai?subject=Webhook%20Early%20Access">
  Email **[support@outx.ai](mailto:support@outx.ai)** to express interest and get notified when webhooks are available.
</Card>