Webhooks & Integrations

Time to read: 6 minutes

Connect your roadmap to external services like Slack, Zapier, and Make. Webhooks send automatic notifications when roadmap events happen — new votes, status changes, comments, and suggestions — so you can build workflows without checking the admin dashboard.

What You’ll Learn

Enabling webhooks on your site
What events trigger notifications
Connecting to Zapier, Slack, and Make
Monitoring webhook deliveries
Testing your webhook setup

Enabling Webhooks

Webhooks are disabled by default. To turn them on:

Go to Roadmap > Settings > Pro
Set Enable Webhooks to Yes
Click Save Changes

What Events Can You Track?

Five types of events can trigger webhook notifications:

Event	What Triggers It
Status Changed	A roadmap item moves to a different status (e.g., Planned → In Progress)
Vote Submitted	A user votes on a roadmap item
Comment Submitted	Someone posts a comment on an item
Suggestion Submitted	A logged-in user submits a new feature suggestion
Guest Suggestion	A guest visitor submits a suggestion

You choose which events to subscribe to when setting up each webhook. For example, you might only want Slack notifications for status changes, but send all events to Zapier.

Setting Up Webhooks

Webhooks are configured through the REST API. You need your site URL and admin access.

Quick Setup

Log in to your WordPress admin
Open your browser’s developer tools (F12) and go to the Console tab
Run wpApiSettings.nonce to get your authentication token
Use the following to create a webhook (replace values with yours):

POST https://yoursite.com/wp-json/roadmap/v1/webhooks

You’ll need to provide:

URL — The endpoint that receives notifications (from Zapier, Make, or your custom service)
Secret — A password for verifying notifications are genuine
Events — Which events to subscribe to

For step-by-step instructions with specific services, see the Integration Recipes guide.

Connecting to Popular Services

Zapier

Zapier can turn roadmap events into actions in 5,000+ apps.

Create a new Zap in Zapier
Choose Webhooks by Zapier as the trigger
Select Catch Hook and copy the webhook URL
Create a roadmap webhook pointing to that URL
Test the connection
Add your action (send email, create Trello card, update spreadsheet, etc.)

For detailed walkthrough, see Integration Recipes → Zapier.

Slack

Get roadmap notifications in a Slack channel:

Create a Slack Incoming Webhook for your channel
Use a middleware service (Zapier or Make) to transform the notification format
Point your roadmap webhook at the middleware
Roadmap events now post to Slack

Make (formerly Integromat)

Create a new Scenario in Make
Add a Webhooks module → Custom webhook
Copy the webhook URL
Create a roadmap webhook pointing to that URL
Build your automation flow

Monitoring Deliveries

The plugin keeps a log of the last 100 webhook deliveries. Each log entry records:

The event type that triggered it
The target URL
Whether the delivery succeeded or failed
The timestamp

Check the delivery logs to debug any issues with your webhook connections.

Testing Your Setup

Before relying on webhooks in production, test them:

Use the test endpoint to send a test ping to your webhook URL
Check that your receiving service (Zapier, Make, etc.) received the test
Verify the data looks correct
Then trigger a real event (vote on an item) and confirm it arrives

Security

Every webhook notification is signed with a secure signature using the secret you provide. The receiving service can verify this signature to confirm the notification genuinely came from your roadmap. This prevents anyone from sending fake notifications to your webhook URL.

For signature verification code examples, see the Webhook Signature Verification Gist.

Troubleshooting

Webhooks not firing

Verify webhooks are enabled in Roadmap > Settings > Pro
Check that you have at least one webhook configured
Make sure the webhook subscribes to the event type you’re testing

Deliveries failing

Check the delivery logs for error details
4xx errors: Your receiving service is rejecting the request — check the URL and authentication
5xx errors: The receiving service is crashing — check their logs
Timeouts: The receiving service is too slow — it should respond within 10 seconds

Signature verification issues

Make sure the secret matches exactly between your roadmap and the receiving service
Secrets are case-sensitive

For developer details (endpoints, payloads, signature verification code), see the REST API Reference.

Next Steps

Integration Recipes – Step-by-step Zapier, Slack, and Make setup
Email & Notifications – Built-in email alerts for roadmap events
Custom Fields – Add structured data to roadmap items

← Changelog Management | Custom Fields →