---
title: "Find Marketing Events by External Event Id"
method: GET
path: "/marketing/marketing-events/2026-09/{externalEventId}/identifiers"
tags: ["Identifiers"]
---

# Find Marketing Events by External Event Id

`GET /marketing/marketing-events/2026-09/{externalEventId}/identifiers`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/marketing/marketing-events/2026-09/{externalEventId}/identifiers`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.marketing_events.read`

This endpoint searches the portal for all Marketing Events whose externalEventId matches the value provided in the request.

It retrieves the objectId and additional event details for each matching Marketing Event.

Since multiple Marketing Events can have the same externalEventId, the endpoint returns all matching results.

Note: Marketing Events become searchable by externalEventId a few minutes after creation.

## Path parameters

- `externalEventId` string, required

## Response `200`

successful operation

- CollectionResponseWithTotalMarketingEventIdentifiersResponse
  - `paging` Paging: Represents the pagination information for navigating through a list of results in the API. It provides details on how to access the previous or next set of results.
    - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required: The ID element at the start of the page
      - `link` string: Link to the next page
    - `prev` PreviousPage: specifies the paging information needed to retrieve the previous set of results in a paginated API response
      - `before` string, required: A string that serves as a cursor indicating the position before the first item in the current set of results, used to fetch the previous set of results.
      - `link` string: A string containing the URL link to the previous page of results.
  - `results` MarketingEventIdentifiersResponse[], required: An array containing the marketing event identifiers. Each item in the array is a MarketingEventIdentifiersResponse object.
    - `appInfo` AppInfo
      - `id` string, required: The ID of the application
      - `name` string, required: The name of the application
    - `externalAccountId` string: The accountId that is associated with this marketing event in the external event application
    - `externalEventId` string, required: The ID that is associated with this marketing event in the external event application
    - `marketingEventName` string, required: The name of the marketing event
    - `objectId` string, required: The internal ID of the marketing event in HubSpot CRM
  - `total` integer, required: An integer representing the total number of marketing event identifiers.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-09-03** (2026-09) `e62ad9a49a20`: 1 info
  - the endpoint scheme security `private_apps` was removed from the API

[Operation history](https://skmtc.dev/hubspot/apis/marketing-marketing-events/changes/marketing/marketing-events/2026-09/:externalEventId/identifiers/get.md)

---

[API](https://skmtc.dev/hubspot/apis/marketing-marketing-events.md) - [All operations](https://skmtc.dev/hubspot/apis/marketing-marketing-events/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/marketing-marketing-events/revisions/3afcf69ad1b4?raw)