Skip to main content

Webhooks

Each form submission triggers a webhook. Enter the webhook URL that we should call in the form editor when creating or updating your form.

Payload​

The webhook is a POST request to your endpoint. Here is an example of the data we might send.

info

The responseValues and meta fields will depend on the components you added to your form and the meta data sent in your request.

Content-Type: application/json

{
    "accountId": "abFMvLv4HafQymWxKDAov",
    "formId": "123456abcdef",
    "formName": "Review AI Draft",
    "reviewId": "123456abcdef",
    "respondingUser": "[email protected]",
    "respondedAt": "2024-10-05T14:48:00.000Z",
    "responseValues": {
        "blogPost": {
            "value": "Regarding the very interesting topic of...",
            "wasEdited": true
        },
        "rating": {
            "value": 7.5,
            "wasEdited": false
        },
        "decisionSelect": {
            "value": "approve"
        }
    },
    "meta": {
        "example": "LLM thread id"
    },
    "gthLinkToReview": "https://app.gotohuman.com/accounts/abFMvLv4HafQymWxKDAov/ReviewRequests/123456abcdef"
}

Make​

If you are using Make to build your AI workflow, read our Make integration guide on how to handle submitted reviews.