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",
"publicUrl": "https://marker.io/i/1234",
"consoleUrl": "https://marker.io/i/1234?console=1"
},
"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
},
"customData": {
"product": "Banana",
"available": true,
"price": 1.23,
"stock": 131,
"brands": [
"The Organic Corp",
"ACME Fruits Inc"
]
},
"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],