Custom events
Send things that happen in your own app (a sign-up, a purchase, a login) and see them in Hubzone.
For AIDownload .mdAll docs as one Markdown filellms.txt (index)llms-full.txt (all docs)OpenAPI (JSON)
Define an event under Data management > Event management: a name and typed properties (text, number, yes/no, date). Each event has its own key, shown once. Your system sends every occurrence to that key with the e-mail address of the person. The occurrence is tied to the contact with that address and shows up on the Occurrences and Analyze tabs.
curl -X POST https://hubzone.app/api/public/events/hze_your_event_key \
-H "content-type: application/json" \
-d '{"email":"[email protected]","properties":{"plan":"pro","seats":5},"occurredAt":"2026-11-10T09:30:00Z"}'{ "id": "1b7e0c52-6f0e-4c7a-9a43-2d5e9d1f0a77", "linkedToContact": true }| Field | Meaning |
|---|---|
email | Required. The person; matched to the contact with this address (case does not matter). |
properties | Optional. Only the properties you defined, each of its type. |
occurredAt | Optional. When it happened, within the last 90 days; the default is now. |
- The key is the only credential: keep it on your server. A new key can be made at any time (the old one stops working at once).
- An address with no contact is still stored (linkedToContact: false).
- Up to 600 calls a minute per address.