---
title: "Submit a webhook event"
method: POST
path: "/v1/integrations/webhooks/{id}/events"
tags: ["Webhook Events"]
---

# Submit a webhook event

`POST /v1/integrations/webhooks/{id}/events`

## Request

- Base URL: `https://docs.grepr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.grepr.ai/v1/integrations/webhooks/{id}/events`
- Auth: API key in header `GREPR-API-KEY`

Accepts one JSON event from the sending system and starts an investigation on each target agent of the integration. The org is taken from the Grepr API key and the integration id from the path. Returns 202 with the started investigation ids. Retries after a 5xx may start duplicate investigations.

## Path parameters

- `id` string, required

## Request body

- string

## Response `202`

Investigation(s) started

## Other responses

- `400`: Body is not valid JSON
- `401`: API key is invalid
- `404`: No such webhook integration
- `409`: The integration has no live target agent to start
- `413`: Body exceeds the size limit
- `503`: At least one target agent could not be started for a transient reason; retry

---

[API](https://skmtc.dev/grepr/apis/grepr-api.md) - [All operations](https://skmtc.dev/grepr/apis/grepr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/grepr/apis/grepr-api/revisions/2a5ce03a0bf0?raw)