webhooks

Create a webhook

Create a webhook for your jobs' events and return its signing secret once.

  • It receives events for every job you started, from any client: the Dashboard, an MCP client or an API key, except Code editor runs.
  • Events: job.needs_input (a job asks a question; the payload has its questions and the page to answer them), job.input_expiring (three minutes left to answer), job.succeeded and job.failed (a job settled), and job.repairing (a repair of a run's tool is under way, and the run ends by maintenance.deadline_at). Without events, it receives all five.
  • No event carries a result. Read the result from the job, through the client that started it.
  • Deliveries are signed with Standard Webhooks, retried for about 14 minutes, and sent only to public HTTPS addresses.
  • Only you can change, test or rotate it; a Business Owner or Admin can also see and delete it. It keeps working if you leave the team.
  • You can hold at most 20 webhooks.
post/v1/webhooks

Request

  • Base URL: https://api.pomerado.ai
  • URL: https://api.pomerado.ai/v1/webhooks
  • Auth: HTTP bearer

Request body

urlstring required
eventsstring[]

an array of at least 1 item(s)

Response

The new webhook and its one-time secret

idstring required

a webhook ID: wh_ and 32 lowercase hex digits

urlstring required
eventsstring[] required
status'active' | 'disabled' required
disabled_reason'manual' | 'gone' | 'unreachable' | 'secret_unreadable' nullable required

Why a disabled webhook sends nothing: manual (turned off), gone (its receiver answered 410), unreachable (20 failed deliveries in a row) or secret_unreadable (rotate its secret)

created_atstring required

a string to be decoded into a Date

last_delivery_atstring required

a string to be decoded into a Date

secretstring required

The Standard Webhooks signing secret (whsec_…), shown only in this response. Verify each delivery's webhook-signature with it.

Example response

{
  "id": "wh_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"
}

Changes

No recorded changes to this operation across all 1 revision of this API.