OPENAPI / COMPONENTS / SCHEMAS

Capture one event

CaptureEventRequest

Submits one event. Event, distinct_id, and project token are required; HTTP 200 only means the service received a well-formed request, not that the event will be ingested. It can update person or group data, so Hub does not proxy it.

object5properties
api_keystringrequired

PostHog project token injected only from caller-local configuration.

distinct_idstringrequired

User distinct ID for event capture or feature-flag evaluation; capture retains at most its first 200 characters.

eventstringrequired

Event name to capture.

propertiesobject

Dynamic event properties, including official event properties such as $identify, $groupidentify, $groups, and $process_person_profile.

timestampstring

Optional ISO 8601 event timestamp.