メインコンテンツへスキップ
GET
/
marketing
/
v3
/
marketing-events
/
{objectId}
objectId別にマーケティングイベントを取得
curl --request GET \
  --url https://api.hubapi.com/marketing/v3/marketing-events/{objectId} \
  --header 'Authorization: Bearer <token>'
{
  "createdAt": "2023-11-07T05:31:56Z",
  "customProperties": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "eventName": "<string>",
  "objectId": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z",
  "appInfo": {
    "id": "<string>",
    "name": "<string>"
  },
  "attendees": 123,
  "cancellations": 123,
  "endDateTime": "2023-11-07T05:31:56Z",
  "eventCancelled": true,
  "eventCompleted": true,
  "eventDescription": "<string>",
  "eventOrganizer": "<string>",
  "eventStatus": "<string>",
  "eventType": "<string>",
  "eventUrl": "<string>",
  "externalEventId": "<string>",
  "noShows": 123,
  "registrants": 123,
  "startDateTime": "2023-11-07T05:31:56Z"
}
次のいずれかの製品またはそれ以上が必要です。
Marketing HubMarketing Hub -無料ツール
Sales HubSales Hub -無料ツール
Service HubService Hub -無料ツール
Content HubContent Hub -無料ツール

認証

Authorization
string
header
必須

The access token received from the authorization server in the OAuth 2.0 flow.

パスパラメータ

objectId
string
必須

HubSpotのマーケティングイベントの内部ID

レスポンス

successful operation

createdAt
string<date-time>
必須

マーケティングイベントの作成日時

customProperties
object[]
必須
eventName
string
必須

マーケティングイベントの名前

objectId
string
必須

HubSpotのマーケティングイベントの内部ID

updatedAt
string<date-time>
必須

マーケティングイベントの更新日時

appInfo
object
attendees
integer<int32>

マーケティングイベントの参加済みコンタクトレコードの数

cancellations
integer<int32>

マーケティングイベントのキャンセル済みコンタクトレコードの数

endDateTime
string<date-time>

マーケティングイベントの終了日時

eventCancelled
boolean

マーケティングイベントがキャンセルされたかどうかを示します

eventCompleted
boolean

マーケティングイベントが完了したかどうかを示します

eventDescription
string

マーケティングイベントの説明。

eventOrganizer
string

マーケティングイベントの主催者の名前

eventStatus
string

マーケティングイベントのステータス

eventType
string

マーケティングイベントのタイプ

eventUrl
string

マーケティングイベントを管理できる外部イベントアプリケーションのURL

externalEventId
string

外部イベントアプリケーションでこのマーケティングイベントに関連付けられているID

noShows
integer<int32>

マーケティングイベントの欠席コンタクトレコードの数

registrants
integer<int32>

マーケティングイベントの登録済みコンタクトレコードの数

startDateTime
string<date-time>

マーケティングイベントの開始日時

Last modified on December 9, 2025