HubSpot: List — marketing Events get Marketing Events

← Marketing events operations · Get started

Operation hubspot.marketing_events_get_marketing_events

Provider route: GET /marketing/marketing-events/2026-09. Alter supplies the connection’s credentials and routing.

Call through Alter

Install @alter-ai/sdk @alter-ai/hubspot with npm, or alter-sdk-hubspot with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { HubSpotIntegration } from "@alter-ai/hubspot";

async function execute(input: Parameters<HubSpotIntegration["marketingEvents"]["getMarketingEvents"]>[0]) {
  const app = new App({ apiKey: process.env.ALTER_API_KEY! });
  try {
    const provider = new HubSpotIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
    const call = await provider.marketingEvents.getMarketingEvents(input);
    const result = await call.wait();
    return result.bodyJson();
  } finally {
    await app.close();
  }
}

import os
from alter_sdk import App
from alter_sdk_hubspot import HubSpotIntegration

async def execute(arguments):
    async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
        provider = HubSpotIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
        call = await provider.marketing_events.get_marketing_events(arguments)
        result = await call.wait()
        return result.body_json()

Input

Field	Type	Presence	Description and constraints
$	object	Root	Additional keys: not allowed
query	object	Optional	Additional keys: not allowed
query.after	string	Optional
query.limit	integer	Optional	Default: 10 Format: int32

Response

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

Field	Type	Presence	Description and constraints
$	Model	Root	Expand List — marketing Events get Marketing Events — response body

Referenced models: List — marketing Events get Marketing Events — response body

Schemas

List — marketing Events get Marketing Events — response body

Field	Type	Presence	Description and constraints
$	object	Root
paging	Model	Optional	Expand List — marketing Events get Marketing Events — response body — paging
results	array	Required within parent	An array of marketing event public read responses, each containing details about a specific marketing event.
results[]	Model	Each item	Expand Get Marketing Event by object Id — response body

Referenced models: List — marketing Events get Marketing Events — response body — paging, Get Marketing Event by object Id — response body

List — marketing Events get Marketing Events — response body — paging

Field	Type	Presence	Description and constraints
$	object	Root	Paging information for forward-only pagination. Contains the next page reference when more results are available; omitted or empty on the last page.
next	Model	Optional	Expand List — marketing Events get Marketing Events — response body — paging next

Referenced models: List — marketing Events get Marketing Events — response body — paging next

Get Marketing Event by object Id — response body

Field	Type	Presence	Description and constraints
$	object	Root
appInfo	Model	Optional	Expand Get Marketing Event by object Id — response body — app Info
attendees	JSON	Optional
attendees (anyOf 1)	integer	Alternative	Number of attended contact records of a marketing event Format: int32
attendees (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
cancellations	JSON	Optional
cancellations (anyOf 1)	integer	Alternative	Number of cancelled contact records of a marketing event Format: int32
cancellations (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
createdAt	string	Required within parent	The creation date and time of the marketing event Format: date-time
customProperties	array	Required within parent	An array of custom properties associated with the event.
customProperties[]	Model	Each item	Expand Get Marketing Event by object Id — response body — custom Properties item
endDateTime	string	Optional	The end date and time of the marketing event Format: date-time
eventCancelled	boolean	Optional	Indicates if the marketing event has been cancelled
eventCompleted	boolean	Optional	Indicates if the marketing event has been completed
eventDescription	string	Optional	The description of the marketing event
eventName	string	Required within parent	The name of the marketing event
eventOrganizer	string	Optional	The name of the organizer of the marketing event
eventStatus	string	Optional	The status of the marketing event
eventStatusV2	string	Optional	The version 2 status of the event, represented as a string.
eventType	string	Optional	The type of the marketing event
eventUrl	string	Optional	A URL in the external event application where the marketing event can be managed
externalEventId	string	Optional	The ID that is associated with this marketing event in the external event application
noShows	JSON	Optional
noShows (anyOf 1)	integer	Alternative	Number of no-show contact records of a marketing event Format: int32
noShows (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
objectId	string	Required within parent	The internal ID of the marketing event in HubSpot
registrants	JSON	Optional
registrants (anyOf 1)	integer	Alternative	Number of registered contact records of a marketing event Format: int32
registrants (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
startDateTime	string	Optional	The start date and time of the marketing event Format: date-time
updatedAt	string	Required within parent	The update date and time of the marketing event Format: date-time

Referenced models: Get Marketing Event by object Id — response body — app Info, Get Marketing Event by object Id — response body — custom Properties item

List — marketing Events get Marketing Events — response body — paging next

Field	Type	Presence	Description and constraints
$	object	Root	Specifies the paging information needed to retrieve the next set of results in a paginated API response
after	string	Required within parent	The ID element at the start of the page
link	string	Optional	Link to the next page

Get Marketing Event by object Id — response body — app Info

Field	Type	Presence	Description and constraints
$	object	Root
id	string	Required within parent	The ID of the application
name	string	Required within parent	The name of the application

Get Marketing Event by object Id — response body — custom Properties item

Field	Type	Presence	Description and constraints
$	object	Root
name	string	Required within parent	The name of the property in the CRM
value	string	Required within parent	The value of the property in the CRM

Policy, approvals and errors

SDK function policy ID: hubspot.marketing_events_get_marketing_events. Catalog operation: marketing_events_get_marketing_events. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Required provider scopes: ["crm.objects.marketing_events.read"]

Official provider source