> For the complete documentation index, see [llms.txt](https://docs.ibexa.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ibexa.ai/developers/rest-api/webhooks/receive-webhook.md).

# Receive webhook

Public endpoint for receiving inbound webhook requests. No authentication required.

```json
{"openapi":"3.1.0","info":{"title":"Ibexa Agentic Marketing Platform","version":"0.1.0"},"paths":{"/api/v1/webhooks/{token}":{"post":{"tags":["webhooks","public"],"summary":"Receive webhook","description":"Public endpoint for receiving inbound webhook requests. No authentication required.","operationId":"webhooks-receive_webhook","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}],"description":"JSON payload forwarded to the agent as execution arguments.","title":"Agent Args"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookResponseSchema"}}}},"401":{"description":"User not authenticated","content":{"application/json":{}}},"403":{"description":"User lacks permission","content":{"application/json":{}}},"404":{"description":"Resource not found or user has no permission to access it","content":{"application/json":{}}},"409":{"description":"Webhook call is already being processed","content":{"application/json":{}}},"429":{"description":"Rate limit exceeded; retry after the time given in Retry-After.","content":{"application/json":{}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Maximum requests permitted per 60-second window.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Epoch second at which the oldest in-window slot ages out.","schema":{"type":"integer"}}}}}}}},"components":{"schemas":{"WebhookResponseSchema":{"properties":{"execution_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Execution Id"},"status":{"type":"string","title":"Status"}},"type":"object","required":["execution_id","status"],"title":"WebhookResponseSchema","description":"Response schema for webhook endpoint."}}}}
```