Skills/Webhook Inbox/Poll an inbox

Poll an inbox

Free

Read back the HTTP requests captured by a webhook inbox. Returns each request's method, headers, body, and timestamp. Optionally pass a since marker to fetch only requests that arrived after a previous poll, so you can incrementally check for new arrivals.

Cost

Free

What it accepts

Set these inside the intent when you run it.

inbox_idrequired

The ID of the inbox to poll, returned when the inbox was created.

sinceoptional

Only return captures that arrived after this marker, for incremental polling.

What you get back

A list of captured HTTP requests, each with method, headers, body, and timestamp.

Run it

Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the Webhook Inbox skill will route from your intent instead.)

curl -X POST "https://skill.askfaro.com/skills/hooks/run" \
  -H "Authorization: Bearer $FARO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"intent":{"operation":"poll","inbox_id":"inbox_abc123","since":"cap_xyz789"}}'

Example requests

  • Check what came into my webhook inbox.
  • Has anything arrived in inbox abc123 yet?
  • Poll my webhook inbox and show me the latest request.