Agent skill · marketing growth · jeremylongshore
maintainx-webhooks-events
Implement MaintainX webhook handling and event-driven integrations.
Why this skill is useful
Provides specific commands and patterns for integrating with MaintainX webhooks that the AI wouldn't reliably generate on its own.
What it needs
Requires curl, express installed locally. Requires maintainx account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
MaintainX Webhooks & Events Overview Build real-time integrations with MaintainX using webhooks for work order updates, asset changes, and maintenance notifications. MaintainX fires webhook events when key resources change. Prerequisites MaintainX account with API access HTTPS endpoint accessible from the internet (ngrok for local dev) MAINTAINXAPIKEY environment variable configured Instructions Step 1: Register a Webhook Step 2: Webhook Receiver (Express) Step 3: Event Router Step 4: Idempotency Store Step 5: Local Development with ngrok Step 6: List and Manage Webhooks Output Webhook endpoint with HMAC signature verification Event router dispatching to type-specific handlers Idempotency guard preventing duplicate processing Local dev setup with ngrok for testing webhooks Webhook registration and management via REST API Error Handling Issue Cause Solution ------- ------- ---------- 401 on webhook registration Invalid API key Verify MAINTAINXAPIKEY Webhook not firing URL not reachable Ensure HTTPS, check firewall, test with ngrok Duplicate events Retries from MaintainX Implement idempotency with event ID deduplication Signature mismatch Wrong secret or body mutation Verify raw body is used for HMAC, check secret value Resources MaintainX API Reference ngrok Documentation Webhook Security Best Practices Next Steps For performance optimization, see maintainx-performance-tuning. Examples Slack notification on high-priority work orders: Polling fallback when webhooks are unavailable:
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/maintainx-webhooks-events