Webhook Owner Report

This documents the webhook payload that Host Tools will POST to your configured webhook URL when an owner report is published.

Note: This is not an API endpoint you call.
This documents the requests that Host Tools sends TO your webhook URL.

When triggered:

  • ownerReport.published: a draft was published, from Owner Statements in Host Tools, /api/publishReport/{reportID} or the MCP.

Each report is sent once, with every line, as /api/getReport/{reportID} returns it. A published report never changes and is never deleted, so no other event follows. Creating, refreshing or deleting a draft sends nothing: poll /api/getReports with updatedSince for drafts. OAuth clients only get this webhook with the ownerStatements:read scope.

Handling the webhook:

  1. Your endpoint should respond with HTTP 200 status
  2. Process the data asynchronously if needed
  3. Respond within 30 seconds
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Webhook payload sent by Host Tools

Owner report webhook payload

string
enum
required

Webhook type

Allowed:
string
enum
required

What happened

Allowed:
document
object
required

The report as /api/getReport/{reportID} returns it, with every line. A published report never changes, so this is final.

Response

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json