[ENG-3949] feat(hubspot): Event Occurrences

[Cobalt0s]

[linear]

ENG-3949

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
Ampersand	🟢 Ready	View Preview	May 29, 2026, 11:17 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[Cobalt0s]

• [ENG-3949] feat(hubspot): Event Occurrences #619 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[RajatPawar]

Can you please add a couple of lines about what events do at the beginning? i.e. an event is captured during form submissions, mail delivery, sequence changes, etc. This will help builders understand the relevance of events to their use case. Especially since HubSpot has used interchanging functionality in the past for it.

[RajatPawar]

1. I'd move this before the naming rule and probably run it by an LLM to tighten up the wording
2. Could you also mention that e_ events are mostly standard, and a_ may be custom, and that e_ events are therefore generally safe to use across consumers?

[Cobalt0s]

Addressed all the comments in this commit: e823ed6

I have not found evidence that a_ signifies as custom object. However I did create the custom definition and sent some custom events.

The API behavriour summary:

1. Creating custom event definition.

POST /events/2026-03/event-definitions {
    "label": "This is my event",
    "includeDefaultProperties": true,
    "propertyDefinitions": []
}

2. Listing definitions.

GET /events/2026-03/event-definitions:
 "results": [
        {
            "labels": {
                "singular": "This is my event",
                "plural": "This is my event"
            },
            "name": "this_is_my_event",
            "id": "203766427",
            "fullyQualifiedName": "pe148543157_this_is_my_event",
         }
]

3. Push some events.

POST /events/2026-03/send {
  "eventName": "pe148543157_this_is_my_event",
  "objectId": "783099041997",
  "properties": {}
}

4. Query these custom events.

[RajatPawar]

Could we add a sample integration for a timeline usecase? i.e. capturing notes, calls, a few marketing events and campaigns?

[Cobalt0s]

This is present in the samples repo: https://github.com/amp-labs/samples/blob/94a3cf7778aa4a39121813cb6eefad47a2b5b28e/hubspot/amp.yaml#L89

Samples repo is always referenced from the docs:

docs/src/provider-guides/hubspot.mdx

Line 85 in cf92dc0

For an example manifest file, visit our [samples repo on Github](https://github.com/amp-labs/samples/blob/main/hubspot/amp.yaml).

Do you want me to duplicate the definition

        - objectName: AMPERSAND-event-occurrences-e_form_view_v2
          mapToName: formViews
          mapToDisplayName: "Form Views"
          destination: defaultWebhook
          schedule: "*/10 * * * *"
          requiredFields:
            - fieldName: objectId
            - fieldName: objectType
          optionalFieldsAuto: all

[RajatPawar]

I would instruct builders to check the spelling if they receive errors when deploying it (there are two c and two rs in the spelling)