This guide will walk you through setting up Marker.io to send issues to any platform using Zapier's webhook integration. Follow these simple steps to get your project up and running.
Set Up a Zap in Zapier
Log in to your Zapier account and create a new Zap.
For the Trigger app, search for Webhooks by Zapier.
Select the Catch Hook event.
Click Continue.
Zapier will generate a unique webhook URL. Copy this URL to your clipboard—you'll need it soon.
Create a New Project in Marker.io
Navigate to Marker.io and log in.
Create a new project by clicking the New Project button.
Name your project and enter the website URL where you'd like to collect issues.
Under Integration, select Webhooks.
Paste the webhook URL from Zapier into the appropriate field.
Click Create Project to finalize your setup.
Test the Webhook Integration
Once your Marker.io project is set up, it will automatically send a sample issue with test data to the Zapier webhook URL.
If You Don’t Receive the Test Data:
Go to your Marker.io project’s Settings.
Under Endpoint, click Send Sample Issue to manually send a test issue to Zapier.
Verify the Data in Zapier
Return to Zapier and click on Find Data in your Zap.
Click Test & Review to see the data sent from Marker.io.
Zapier should display the test issue and its associated data.
If the test issue doesn't appear, try sending a sample issue again from Marker.io and click Get More Samples in Zapier.
Set Up the Action in Zapier
Now, it's time to decide what happens after Zapier receives an issue from Marker.io. You can choose from thousands of available apps or use a pre-made template:
Search for your preferred issue tracker or project management tool.
Select the action you want to occur when an issue is received.
You can, for example, create an issue in your tool, send a notification email, or perform other automated tasks.
Note
We have developed native integrations for many popular issue trackers and project management tools. See here for a complete listing:
Add Signature Token Validation (Optional, but Recommended)
NOTE: This section is a work in progress.
To make sure that only Marker.io can use your webhook, you can validate the webhook signature. This helps protect your webhook from unauthorized use.
How to Validate the Signature Token in Zapier:
After setting up the webhook, add the Code by Zapier action to your Zap.
Choose Python or JavaScript to write a small script that checks the signature.
Python Example:
import hmac
import hashlib
import base64
import json
# --- Helper function for safe header extraction ---
def get_header(headers, header_name):
"""
Retrieve a header value from the headers dictionary, accounting for case-insensitivity.
"""
for key, value in headers.items():
if key.lower() == header_name.lower():
return value
return None
# --- Begin webhook signature validation ---
# 1. Retrieve the raw payload.
# IMPORTANT: Ensure this is the exact raw body as received.
raw_payload = input_data.get('body')
if not isinstance(raw_payload, str):
# If the body is parsed into a dict, re-serialize it.
# Note: This may not match the original raw payload if the provider’s JSON
# encoding is different (e.g., whitespace, key ordering).
raw_payload = json.dumps(raw_payload, separators=(',', ':'))
# 2. Retrieve the signature from headers.
headers = input_data.get('headers', {})
signature = get_header(headers, 'x-marker-signature')
if signature is None:
return {'validation_status': 'failed', 'error': 'Missing signature header'}
# 3. Your secret token (replace with your actual secret key)
secret_token = 'your_marker_io_secret_token'
# 4. Compute the expected signature using HMAC with SHA-256.
digest = hmac.new(
secret_token.encode('utf-8'),
raw_payload.encode('utf-8'),
hashlib.sha256
).digest()
# Base64-encode the computed digest.
expected_signature = base64.b64encode(digest).decode('utf-8')
# 5. Compare the provided signature to the expected signature using a timing-safe comparison.
if hmac.compare_digest(signature, expected_signature):
return {'validation_status': 'success'}
else:
return {'validation_status': 'failed'}
This script checks if the signature sent with the webhook matches the one you generate using your secret token.
Turn On Your Zap
Once everything is set up, switch your Zap on by clicking Turn on Zap. Your Zap is now live, and Marker.io will send issues directly to your chosen platform via Zapier.
Explore Additional Automation Options
The possibilities are vast when using Marker.io with Zapier. Some ideas include:
Creating an issue in your project management tool.
Sending an email notification to a group of people.
Automatically transforming and formatting the issue data.
Need Help?
If you have any questions, comments, or corrections, chat with us at the bottom right of our web pages.