Webhooks

Create webhook endpoints for MCP-visible events such as generated media, failed jobs, published posts, automation output, and completed tool calls.

View Markdown

Supported events

Event typestxt

avatar.generated
avatar.failed
product_scene.generated
product_scene.failed
hook.generated
hook.failed
ai_clone.generated
ai_clone.failed
video.completed
video.failed
slideshow.exported
scheduled_post.published
scheduled_post.failed
scheduled_post.cancelled
automation.generated
tool.completed

Create a webhook

CLIbash

reelsfarm webhooks create \
  --url https://example.com/reelsfarm/webhook \
  --events scheduled_post.published,scheduled_post.failed \
  --agent --yes

SDKts

const webhook = await rf.webhooks.create({
  url: "https://example.com/reelsfarm/webhook",
  events: ["scheduled_post.published", "scheduled_post.failed"],
  description: "Production publish events",
});

Secret is returned once
The signing secret starts with rfmcpwh_ and is returned only when the webhook is created. Store it immediately.

Signature headers

Webhook deliveries include event metadata and an HMAC signature. Verify the signature before trusting the payload.

Headershttp

user-agent: ReelsFarm-MCP-Webhooks/1.0
x-reelsfarm-event-id: evt_123
x-reelsfarm-event-type: scheduled_post.published
x-reelsfarm-signature: sha256=...

Inspect activity

CLIbash

reelsfarm webhooks list --agent
reelsfarm events recent --type scheduled_post.published --agent

SDKts

const webhooks = await rf.webhooks.list();
const events = await rf.events.recent({
  type: "scheduled_post.published",
  limit: 20,
});