Create an inbox

Free

Create a temporary webhook inbox and get back a unique URL you can give to any service to receive callbacks. Optionally set an expiry time or cap the number of requests to retain. Use the returned inbox ID to poll for captured requests later.

Cost

Free

What it accepts

Set these inside the intent when you run it.

ttl_hoursoptional

Hours until the inbox expires and stops accepting requests. Omit for no expiry.

max_capturesoptional

Maximum number of incoming requests to retain in the inbox.

What you get back

An inbox ID and its capture URL ready to receive incoming HTTP requests.

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":"create_inbox","ttl_hours":2,"max_captures":50}}'

Example requests

›Give me a webhook URL I can use to receive Stripe callbacks.
›Create a webhook inbox so I can test my payment integration.
›Set up a capture URL that expires in 2 hours.

← Back to Webhook Inbox