OpenParable
Skip to content
← Back to skills

Webhooks

Apps & Automation
webhooks

Webhooks is an Agent Skill for apps & automation published in the nirholas/XActions repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Create, manage, and test webhooks in XActions. Get notified via HTTP when automation jobs complete, followers change, or operations finish. Use when users want to integrate XActions events into external systems.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/nirholas/XActions/blob/HEAD/skills/webhooks/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/webhooks, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Webhooks

API-powered webhook system for receiving real-time event notifications from XActions.

Entry Points

GoalRouteMethod
Create a webhookPOST /api/webhooksREST API
List webhooksGET /api/webhooksREST API
Update a webhookPATCH /api/webhooks/:idREST API
Delete a webhookDELETE /api/webhooks/:idREST API
Test a webhookPOST /api/webhooks/:id/testREST API

API Usage

Create a webhook

POST /api/webhooks
Authorization: Bearer <token>
Content-Type: application/json

{
  "url": "https://your-server.com/webhook",
  "events": ["operation.complete", "follower.lost", "follower.gained"],
  "secret": "your-signing-secret"
}

Test a webhook

POST /api/webhooks/:id/test
Authorization: Bearer <token>

Sends a test payload to the registered URL.

Supported Events

EventTriggered when
operation.completeAn automation job finishes successfully
operation.failedAn automation job fails
follower.gainedYou gain a new follower
follower.lostYou lose a follower
job.startedA Bull queue job begins
job.completedA Bull queue job completes

Payload Verification

Webhooks are signed with HMAC-SHA256 using your secret:

const signature = req.headers['x-xactions-signature'];
const expected = crypto.createHmac('sha256', secret)
  .update(JSON.stringify(req.body))
  .digest('hex');
const isValid = crypto.timingSafeEqual(
  Buffer.from(signature),
  Buffer.from(expected)
);

Notes

  • Webhook deliveries are retried up to 3 times on failure (exponential backoff)
  • Delivery logs are available via GET /api/webhooks/:id/deliveries
  • Events are dispatched asynchronously from the Bull job queue

Related Skills

  • xactions-mcp-server — AI agent integration alternative to webhooks
  • follower-monitoring — Source of follower.gained / follower.lost events
  • analytics-insights — Pull analytics instead of waiting for events