---
title: "Fire a Custom Webhook Automation"
method: POST
path: "/v1/automations/webhook/{token}"
tags: ["Automation"]
---

# Fire a Custom Webhook Automation

`POST /v1/automations/webhook/{token}`

Fires an automation that has a `custom` webhook trigger. The token in the URL is the secret: any caller that knows the URL can fire the automation, so this endpoint is unauthenticated by design (no API key). The request body is parsed as JSON and embedded into the automation's prompt under `## Trigger Payload`. Non-JSON bodies are wrapped as `{ "raw": "<body>" }`. Bodies larger than 256KB are rejected. Returns `202 Accepted` once the execution is queued; disabled automations, unknown tokens, and automations without a custom trigger all return `404` without distinguishing between the three.

## Path parameters

- `token` string, required

## Request body

- unknown

## Response `202`

Execution queued

- object
  - `accepted` boolean, required

## Other responses

- `404` — Webhook not found (bad token, disabled automation, or no custom trigger)
- `413` — Payload too large (over 256KB)
- `500` — Internal server error

---

[API](https://skmtc.dev/tryreplicas/apis/replica-api.md) · [All operations](https://skmtc.dev/tryreplicas/apis/replica-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tryreplicas/replica-api/revisions/aa3b4c932f7a/schema)
