メインコンテンツへスキップ
GET
外部IDによるマーケティングイベントの取得

Supported products

承認

Authorization
string
header
必須

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

Scopes

crm.objects.marketing_events.read

パスパラメータ

externalEventId
string
必須

外部イベントアプリケーションのマーケティングイベントのID。

クエリパラメータ

externalAccountId
string
必須

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

レスポンス

successful operation

attendees
integer<int32>
必須

このマーケティングイベントに参加したHubSpotコンタクトの数。

cancellations
integer<int32>
必須

このマーケティングイベントに登録したが、後で登録をキャンセルしたHubSpotコンタクトの数。

createdAt
string<date-time>
必須

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

customProperties
object[]
必須

PropertyValuesのリスト。任意のプロパティーの名前と値を指定できます。ただし、HubSpotアカウントのMarketingEventオブジェクトの定義に存在している必要があります。存在していない場合、除外されて、設定されません。 存在させるには、特定のアプリについてHubSpotアカウントのMarketingEventオブジェクトでPropertyGroupを新規作成し、そのHubSpotアカウントで追跡するカスタムプロパティーを作成する必要があります。MarketingEventでデフォルトのプロパティーを新規作成するとすべてのHubSpotアカウントに適用されることになるため、作成しないでください。

eventName
string
必須

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

eventOrganizer
string
必須

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

externalEventId
string
必須

外部イベントアプリケーションのマーケティングイベントのID。

id
string
必須

マーケティングイベントCRMオブジェクトのID。

noShows
integer<int32>
必須

このマーケティングイベントに登録したが、参加しなかったHubSpotコンタクトの数。このフィールドに値が含まれるのはイベントの終了後のみです。

registrants
integer<int32>
必須

このマーケティングイベントに登録したHubSpotコンタクトの数。

updatedAt
string<date-time>
必須

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

endDateTime
string<date-time>

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

eventCancelled
boolean

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

eventCompleted
boolean

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

eventDescription
string

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

eventType
string

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

eventUrl
string

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

objectId
string

マーケティングイベントCRMオブジェクトのID。

startDateTime
string<date-time>

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

最終更新日 2026年10月6日