Webhook events

{
  "event": "review.completed",
  "accountId": "abFMvLv4HafQymWxKDAov",
  "reviewId": "123456abcdef",
  "agentId": "agent123456abcdef",
  "sessionId": "session789abcdef",
  "formId": "123456abcdef",
  "formName": "Review AI Draft",
  "reviewResult": {
    "response": "approved",
    "respondingUser": "[email protected]",
    "respondedAt": "2027-10-05T14:48:00.000Z",
    "data": {
      "crmUpdate": {
        "entryId": "123456abcdef",
        "amount": 42000,
        "stage": "proposal",
        "contact": {
          "name": "John Doe",
          "email": "[email protected]",
          "phone": "+1234567890"
        }
      }
    }
  },
  "meta": {
    "example": "LLM thread id"
  },
  "gthLink": "https://app.gotohuman.com/accounts/abFMvLv4HafQymWxKDAov/inbox/agents/agent123456abcdef/reviews/123456abcdef"
}

{
  "event": "trigger.submitted",
  "accountId": "abFMvLv4HafQymWxKDAov",
  "reviewId": "123456abcdef",
  "agentId": "agent123456abcdef",
  "sessionId": "session789abcdef",
  "formId": "abcdef123456",
  "formName": "Create Marketing Campaign",
  "reviewResult": {
    "respondingUser": "[email protected]",
    "respondedAt": "2027-10-05T14:48:00.000Z",
    "data": {
      "name": "Black Friday Campaign",
      "targetAudience": "customers-active-last-30-days",
      "campaignType": "email"
    }
  },
  "gthLink": "https://app.gotohuman.com/accounts/abFMvLv4HafQymWxKDAov/inbox/agents/agent123456abcdef/reviews/123456abcdef"
}

{
  "event": "review.completed",
  "accountId": "abFMvLv4HafQymWxKDAov",
  "reviewId": "123456abcdef",
  "agentId": "agent123456abcdef",
  "sessionId": "session789abcdef",
  "formId": "123456abcdef",
  "formName": "Review AI Draft",
  "reviewResult": {
    "response": "approved",
    "respondingUser": "[email protected]",
    "respondedAt": "2027-10-05T14:48:00.000Z",
    "data": {
      "crmUpdate": {
        "entryId": "123456abcdef",
        "amount": 42000,
        "stage": "proposal",
        "contact": {
          "name": "John Doe",
          "email": "[email protected]",
          "phone": "+1234567890"
        }
      }
    }
  },
  "meta": {
    "example": "LLM thread id"
  },
  "gthLink": "https://app.gotohuman.com/accounts/abFMvLv4HafQymWxKDAov/inbox/agents/agent123456abcdef/reviews/123456abcdef"
}

{
  "event": "trigger.submitted",
  "accountId": "abFMvLv4HafQymWxKDAov",
  "reviewId": "123456abcdef",
  "agentId": "agent123456abcdef",
  "sessionId": "session789abcdef",
  "formId": "abcdef123456",
  "formName": "Create Marketing Campaign",
  "reviewResult": {
    "respondingUser": "[email protected]",
    "respondedAt": "2027-10-05T14:48:00.000Z",
    "data": {
      "name": "Black Friday Campaign",
      "targetAudience": "customers-active-last-30-days",
      "campaignType": "email"
    }
  },
  "gthLink": "https://app.gotohuman.com/accounts/abFMvLv4HafQymWxKDAov/inbox/agents/agent123456abcdef/reviews/123456abcdef"
}

The webhook is a POST request to your endpoint with Content-Type: application/json.

Events

review.completed - Whenever a review is completed
trigger.submitted - When a trigger form is submitted.

{
  "event": "review.completed",
  "accountId": "abFMvLv4HafQymWxKDAov",
  "reviewId": "123456abcdef",
  "agentId": "agent123456abcdef",
  "sessionId": "session789abcdef",
  "formId": "123456abcdef",
  "formName": "Review AI Draft",
  "reviewResult": {
    "response": "approved",
    "respondingUser": "[email protected]",
    "respondedAt": "2027-10-05T14:48:00.000Z",
    "data": {
      "crmUpdate": {
        "entryId": "123456abcdef",
        "amount": 42000,
        "stage": "proposal",
        "contact": {
          "name": "John Doe",
          "email": "[email protected]",
          "phone": "+1234567890"
        }
      }
    }
  },
  "meta": {
    "example": "LLM thread id"
  },
  "gthLink": "https://app.gotohuman.com/accounts/abFMvLv4HafQymWxKDAov/inbox/agents/agent123456abcdef/reviews/123456abcdef"
}

{
  "event": "trigger.submitted",
  "accountId": "abFMvLv4HafQymWxKDAov",
  "reviewId": "123456abcdef",
  "agentId": "agent123456abcdef",
  "sessionId": "session789abcdef",
  "formId": "abcdef123456",
  "formName": "Create Marketing Campaign",
  "reviewResult": {
    "respondingUser": "[email protected]",
    "respondedAt": "2027-10-05T14:48:00.000Z",
    "data": {
      "name": "Black Friday Campaign",
      "targetAudience": "customers-active-last-30-days",
      "campaignType": "email"
    }
  },
  "gthLink": "https://app.gotohuman.com/accounts/abFMvLv4HafQymWxKDAov/inbox/agents/agent123456abcdef/reviews/123456abcdef"
}

Properties

string

review.completed or trigger.submitted.

string

ID of the review.

string

Use it in subsequent review requests to link reviews of the same session.

string

ID of the review type or trigger form.

string

ID of the agent this review belongs to.

object

The reviewer’s submission once responded.

Hide properties

string

approved or rejected. Reviews only.

string

Email of the reviewer who submitted.

string

ISO 8601 timestamp.

object

Data after the review – same structure as your request data, including any reviewer edits or selections.

object

Echo of any meta you sent with the request.

object

Map of original media URLs to CDN URLs. See Images and videos.

string

Link to open the review in gotoHuman.

GET STARTED

Human reviews

Notifications

Integrations

API Reference

Examples

More

Events

Properties

​Events

​Properties

Events

Properties