Marker.io allows you to send feedback data to custom Webhooks.

Why Webhooks?

Webhooks are automated messages sent from apps when something happens. They have a message—or payload—and are sent to a unique URL—essentially the app's phone number or address.

How do Webhooks work?

The core mechanics of webhooks consist of making an HTTP request to a user’s specified URL. A webhook makes an HTTP callback to a URL that has to be configured by the system which receives the data.

That URL is called the webhook endpoint. Webhook endpoints must be public, and this URL must belong to the receiving system.

Why Marker.io?

With the power of Marker.io, collecting website feedback on Webhooks is a breeze, saving hours of developer time. Collect your website feedback directly into your favorite PM tools and issue trackers with Webhooks.

How to use Marker.io with Webhooks

Add a project within app.marker.io and select Webhooks
Choose a name for your project and provide the URL of the endpoint.

Head over to Marker.io > Add project.
Choose a project name
Select the website you want to report feedback from
Select the Webhooks integration.
Paste your newly created webhook endpoint. Click Create Project.

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"
    ]
  },
  "project": {
    "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 project settings > Webhook 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],

Webhooks Integration