Webhook Inbox

Active

Your agent has no server to receive a callback; this gives it a temporary URL and captures the requests.

2 tools

Create a temporary inbound URL to receive HTTP callbacks an agent has no server for, then poll the captured requests. Great for catching OAuth redirects, payment webhooks, or any callback during a task.

Developer Toolswebhookinboxcallbackhttpreceive

Tools (2)

▶create_inbox

Create a temporary inbound webhook URL that buffers incoming requests for later polling.

Free

Example prompts

“Give me a webhook URL to catch the OAuth callback”
“I need an endpoint to receive a payment confirmation”

Parameters

ttl_hoursintegeroptionaldefault: 24

How long the inbox stays live (max 7 days).

max_capturesintegeroptionaldefault: 100

Max requests to capture before the inbox returns 410.

API Usage

curl -X POST "https://skill.askfaro.com/skills/hooks/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Give me a webhook URL to catch the OAuth callback"
  }
}'

CLI Usage

askfaro describe hooks/hooks.create_inbox

Install pip install askfaro-cli, then askfaro auth login.

▶poll

Return the requests captured by an inbox, optionally only those after a timestamp.

Free

Example prompts

“Did anything hit my webhook inbox yet?”

Parameters

sincestringoptional

ISO-8601 timestamp; only captures after this are returned.

inbox_idstringrequired

Inbox id from create_inbox.

API Usage

curl -X POST "https://skill.askfaro.com/skills/hooks/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Did anything hit my webhook inbox yet?"
  }
}'

CLI Usage

askfaro describe hooks/hooks.poll

Install pip install askfaro-cli, then askfaro auth login.