Webhooks

With webhooks, you can instantly send information to another app or URL after a trigger, like a Meiro form completion. This instant notification lets you build automated workflows to take action on your completions.

If you're instead looking for a non-technical way to sync Meiro challenge completions with other apps, check out our Make integration.

You can find and set up a webhook in the challenge editing mode.

How it works

Webhooks send notifications to a specified URL when triggered by an event. The event trigger is a new challenge completion. When someone completes your challenge, a notification containing the response data gets sent to your URL in JSON format via a POST request.

How to set it up

To set up this integration:

1. Log in to your platform or tool where you want to configure the webhook.

2. Create a new webhook there

   • Set up the webhook URL

   • Specify POST HTTP method

3. Save the Webhook and paste the URL in the Meiro settings

You can test the integration using a free environment that provides the webhook URLs, for example, Webhook.site.

Once the integration is set up, the requests will start being sent to your external service:

Below you can find a sample raw content of the webhook Meiro provides:

{
  "id": "b0eb1479-9672-4c05-848d-c39a97025eea",
  "submittedAt": "2024-06-21T02:24:23.309Z",
  "result": {
    "points": 2,
    "results": [
      {
        "answers": [
          {
            "answerId": "cadb8821-3023-4e1a-ab8b-d85b717e713c",
            "isCorrect": false,
            "answerTitle": "A music streaming service"
          }
        ],
        "isCorrect": false,
        "questionId": "ac0cd785-aa46-4505-9440-d03b421df89a",
        "correctPoints": 1,
        "questionTitle": "What does Web3 refer to?"
      },
      {
        "answers": [
          {
            "answerId": "f5e3686a-dc65-4330-b524-ad19a5c5cdbd",
            "isCorrect": false,
            "answerTitle": "Better audio quality"
          }
        ],
        "isCorrect": false,
        "questionId": "f49cfee3-f7b0-4df3-a990-b0e0687f9084",
        "correctPoints": 1,
        "questionTitle": "What feature distinguishes Web3 from its predecessors?"
      },
      {
        "answers": [
          {
            "answerId": "53843dc1-f64f-4521-886b-9e9dcdf9255f",
            "isCorrect": true,
            "answerTitle": "Blockchain"
          }
        ],
        "isCorrect": true,
        "questionId": "2d3f981c-f068-4402-9b16-a0d9fe641f0b",
        "correctPoints": 1,
        "questionTitle": "Which foundational technology does Web3 rely on?"
      },
      {
        "answers": [
          {
            "answerId": "ce0313ae-b2a8-41bc-8430-0e24e92265ca",
            "isCorrect": false,
            "answerTitle": "Decoder Contract"
          }
        ],
        "isCorrect": false,
        "questionId": "27c9cad3-1255-456a-abb5-368b883d7519",
        "correctPoints": 1,
        "questionTitle": "What concept is essential for Web3 and refers to self-executing contracts with the terms of the agreement directly written into code?"
      },
      {
        "answers": [
          {
            "answerId": "c42b2720-b4b4-4209-9753-95c94db85cd4",
            "isCorrect": false,
            "answerTitle": "Verisign Managed DNS"
          }
        ],
        "isCorrect": false,
        "questionId": "b9967994-f144-4f57-ad03-a9e6bd5d8310",
        "correctPoints": 1,
        "questionTitle": "Which of the following aims to decentralize web domains using Web3 technology?"
      },
      {
        "answers": [
          {
            "answerId": "58502015-4662-4175-8a68-64c0862474cf",
            "isCorrect": false,
            "answerTitle": "Monero"
          }
        ],
        "isCorrect": false,
        "questionId": "4642f468-7987-4993-b310-1f1fc9dcace2",
        "correctPoints": 1,
        "questionTitle": "Which of the following cryptocurrencies is most associated with Web3?"
      },
      {
        "answers": [
          {
            "answerId": "21fbcc87-cfd5-4e5e-a78c-81e2956c4438",
            "isCorrect": true,
            "answerTitle": "Web3.js"
          }
        ],
        "isCorrect": true,
        "questionId": "5697b588-2ad4-492b-a36f-9ca49adfdafd",
        "correctPoints": 1,
        "questionTitle": "What open-source JavaScript library is commonly used for interacting with the Ethereum blockchain and the decentralized web (web3)?"
      },
      {
        "answers": [
          {
            "answerId": "335d22a6-fba7-4b0d-951d-03b471d17ab6",
            "isCorrect": false,
            "answerTitle": "A mobile application"
          }
        ],
        "isCorrect": false,
        "questionId": "fc0b5913-e127-4639-a331-25235146d2fd",
        "correctPoints": 1,
        "questionTitle": "What does the term 'Decentralized Application' or 'DApp' refer to in the context of Web3?"
      },
      {
        "answers": [
          {
            "answerId": "ce71f4e0-cd91-4c5d-83d7-a0efee090fbd",
            "isCorrect": false,
            "answerTitle": "Digital Application Objects"
          }
        ],
        "isCorrect": false,
        "questionId": "570abce3-8db5-479c-85b7-d8bc0f4f15c8",
        "correctPoints": 1,
        "questionTitle": "In the context of Web3, what does DAO stand for?"
      },
      {
        "answers": [
          {
            "answerId": "b976352e-b666-4ce7-98d9-965c031ee680",
            "isCorrect": false,
            "answerTitle": "A spam filter"
          }
        ],
        "isCorrect": false,
        "questionId": "879e266d-2a92-43e5-bd57-490398101e5c",
        "correctPoints": 1,
        "questionTitle": "What is Metamask?"
      }
    ],
    "totalPoints": 10,
    "challengeTime": 14035
  },
  "leadForm": {
    "fields": [
      {
        "label": "Name",
        "value": "Valeriya",
        "widgetId": "0db0a7fb-673e-4ad7-9f3f-c2c0463838f9"
      },
      {
        "label": "Email",
        "value": "valeriya@test.com",
        "widgetId": "0d133974-b392-4b83-9425-efa473c0a037"
      }
    ],
    "leadFormId": "09f7f3a4-2c18-4eb9-adeb-5f55b9e2fd2b"
  }
}