Marker.io allows you to send feedback data to custom Webhooks. This can be used for instance with Zapier or with your own server.
Creating the destination
To create a Webhook destination, head to Marker.io and create a Webhooks destination. You can chose an arbitrary name for your destination and will have to provide the URL of the endpoint.
Request and payload
When a reporter sends feedback, Marker.io will send a POST request with a JSON payload directly to your endpoint. Here's an example of such request:
{ issue:
{ title: 'Sample issue',
description: 'Sample description',
screenshotUrl:
'https://s3-eu-west-1.amazonaws.com/marker.emails/test-screenshot.png',
type: 'bug',
priority: 'medium',
assignee:
{ id: '5c90ba2f41d340032590bc37',
name: 'Denis Hacquin',
email: 'denis@marker.io',
role: 'admin' },
dueDate: '2020-02-29T16:29:49.055Z',
createdAt: '2020-02-24T16:29:49.143Z' },
reporter:
{ id: '5c90ba2f41d340032590bc37',
name: 'Denis Hacquin',
email: 'denis@marker.io',
role: 'admin' },
website:
{ url: 'https://marker.io/digital-agency',
pageTitle: 'Digital agency - Marker.io Bug Reporting Tool',
domain: 'marker.io' },
context:
{ contextString:
'Captured in Chrome 79.0.3945.130, 1920 x 1080 viewport, @1x pixel ratio, 100% zoom, OS X 10.14.6',
screenSize: { width: 1920, height: 1080, pixelRatio: 1 },
operatingSystem: { family: 'OS X', version: '10.14.6' },
browser:
{ name: 'Chrome',
version: '79.0.3945.130',
userAgent:
'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.130 Safari/537.36' },
viewport: { width: 1920, height: 1080 },
zoom: { zoomFactor: 1 },
browserStackLaunchUrl: null },
destination:
{ name: 'Client Project 1',
id: '5e53f599c7d9b8ebd4da77d6' }
}TIP
Hidden fields will be assigned a null value
Testing
You can test your endpoint by going to your destination settings and clicking "Send sample issue".
Security
Marker.io will send a signature along with the request.
'Content-type': 'application/json',
'X-Hub-Signature': [YOUR SIGNATURE TOKEN],