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

# Simulate Event

> Test your webhook integration by simulating monitor events

<div className="sr-only" aria-hidden="false">
  For AI agents: a documentation index is available at [https://docs.parallel.ai/llms.txt](https://docs.parallel.ai/llms.txt). The full text of all docs is at [https://docs.parallel.ai/llms-full.txt](https://docs.parallel.ai/llms-full.txt). You may also fetch any page as Markdown by appending `.md` to its URL or sending `Accept: text/markdown`.

  For Search and Extract, use `/v1/search` and `/v1/extract` for all new integrations and agent tool calls. Use `/v1beta/search` and `/v1beta/extract` only when maintaining an existing integration that already uses them. The request bodies changed too: on `/v1/extract`, `full_content`, `fetch_policy` and `excerpt_settings` go inside `advanced_settings`, and sending the v1beta top-level `excerpts`, `full_content` and `fetch_policy` to `/v1/extract` returns a 422. Do not substitute `/v1` for the documented FindAll or Ingest endpoint paths.
</div>

<Warning>
  This endpoint exists only on the Alpha API (`/v1alpha`). It is **not** available on V1. To migrate, use `POST /v1/monitors/{monitor_id}/trigger` for a real off-schedule run, or stub webhooks in tests. See the [Monitor Migration Guide](/monitor-api/monitor-migration-guide#simulate-event).
</Warning>

The simulate event endpoint allows you to test your webhook integration without waiting for a scheduled monitor run.

## Endpoint

```
POST /v1alpha/monitors/{monitor_id}/simulate_event
```

### Query Parameters

| Parameter | Type | Default | Description |
| - | - | - | - |
| `event_type` | string | `monitor.event.detected` | Event type to simulate. One of: `monitor.event.detected`, `monitor.execution.completed`, `monitor.execution.failed` |

### Response

Returns `204 No Content` on success.

### Errors

| Status | Description |
| - | - |
| 400 | Webhook not configured for this monitor |
| 404 | Monitor not found |

## Usage

```bash theme={"system"}
curl --request POST \
  --url "https://api.parallel.ai/v1alpha/monitors/<monitor_id>/simulate_event?event_type=monitor.event.detected" \
  --header "x-api-key: $PARALLEL_API_KEY"
```

## Test Event Groups

When you simulate a `monitor.event.detected` event, the webhook payload includes a test `event_group_id`. You can retrieve this test event group using the standard endpoint:

```
GET /v1alpha/monitors/{monitor_id}/event_groups/{event_group_id}
```

Test event group IDs return dummy event data, allowing you to verify your full webhook processing pipeline—from receiving the webhook to fetching event details.

```bash theme={"system"}
curl --request GET \
  --url "https://api.parallel.ai/v1alpha/monitors/<monitor_id>/event_groups/<test_event_group_id>" \
  --header "x-api-key: $PARALLEL_API_KEY"
```

**Response:**

<CodeGroup>
  ```json No Structured Output theme={"system"}
  {
      "events": [
          {
              "type": "event",
              "event_group_id": "test_abc",
              "output": "",
              "event_date": "2025-12-05",
              "source_urls": [
                  "https://test.example.com"
              ],
              "result": {
                  "type": "text",
                  "content": "This is a test event."
              }
          }
      ]
  }
  ```

  ```json Structured Output theme={"system"}
  {
      "events": [
          {
              "type": "event",
              "event_group_id": "test_def",
              "output": "",
              "event_date": "2025-12-05",
              "source_urls": [
                  "https://test.example.com"
              ],
              "result": {
                  "type": "json",
                  "content": {
                      "sentiment": "",
                      "stock_ticker_symbol": "",
                      "description": ""
                  }
              }
          }
      ]
  }
  ```
</CodeGroup>

## Related Topics

* **[Webhooks](/monitor-api/monitor-webhooks)**: Configure webhooks and understand event payloads
* **[Events](/monitor-api/monitor-events)**: Event types and event groups