Track site events

post

Authorizations

useruser-internaluser-staffintegrationintegration-installation

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organizationIdstringRequired

A unique entity identifier

Pattern: ^[a-zA-Z0-9_-]+$

siteIdstringRequired

The unique id of the site

Body

application/json

Responses

204

Events have been tracked.

No content

post/orgs/{organizationId}/sites/{siteId}/insights/events

HTTPcURLJavaScriptPython

POST /v1/orgs/{organizationId}/sites/{siteId}/insights/events HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 435

{
  "events": [
    {
      "session": {
        "visitorId": "text",
        "sessionId": "text",
        "cookies": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "ip": "text",
        "userAgent": "text",
        "language": null,
        "referrer": null,
        "visitorAuthClaims": "[Circular Reference]"
      },
      "location": {
        "url": "https://example.com",
        "displayContext": "site",
        "siteSection": null,
        "siteSpace": null,
        "siteShareKey": null,
        "space": null,
        "revision": null,
        "page": null
      },
      "timestamp": "2026-07-23T00:09:44.021Z",
      "type": "page_view"
    }
  ]
}

204

Events have been tracked.

No content