---
title: "External events webhook (provider → PolyAI)"
method: POST
path: "/v1/external-events/webhook"
tags: ["External Events"]
---

# External events webhook (provider → PolyAI)

`POST /v1/external-events/webhook`

External providers POST results back to the Agent runtime. PolyAI extracts the external event ID according to the query parameters, binds the data to the active conversation, and (optionally) feeds it to the LLM.

## Query parameters

- `event_id_location` 'headers' | 'querystring' | 'payload', required
- `event_id_path` string, required
- `account_id` string, required
- `project_id` string, required

## Request body

- object

## Response `201`

Accepted – the external event has been received and queued for processing.

## Other responses

- `400` — Malformed request (for example, external event ID not valid or not found in request).
- `401` — Unauthorized – invalid or missing API key.
- `500` — Internal Server Error.

---

[API](https://skmtc.net/poly/apis/polyai-agents-api.md) · [All operations](https://skmtc.net/poly/apis/polyai-agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poly/polyai-agents-api/revisions/76f3c606e395/schema)