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],
Did this answer your question?