メインコンテンツへスキップ
PUT
/
marketing
/
marketing-events
/
2026-03
/
events
/
{externalEventId}
マーケティングイベントを作成または更新
curl --request PUT \
  --url https://api.hubapi.com/marketing/marketing-events/2026-03/events/{externalEventId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customProperties": [
    {
      "dataSensitivity": "high",
      "isEncrypted": true,
      "isLargeValue": true,
      "name": "<string>",
      "persistenceTimestamp": 123,
      "requestId": "<string>",
      "selectedByUser": true,
      "selectedByUserTimestamp": 123,
      "source": "ACADEMY",
      "sourceId": "<string>",
      "sourceLabel": "<string>",
      "sourceMetadata": "<string>",
      "sourceUpstreamDeployable": "<string>",
      "sourceVid": [
        123
      ],
      "timestamp": 123,
      "unit": "<string>",
      "updatedByUserId": 123,
      "useTimestampAsPersistenceTimestamp": true,
      "value": "<string>"
    }
  ],
  "eventName": "<string>",
  "eventOrganizer": "<string>",
  "externalAccountId": "<string>",
  "externalEventId": "<string>",
  "endDateTime": "2023-11-07T05:31:56Z",
  "eventCancelled": true,
  "eventCompleted": true,
  "eventDescription": "<string>",
  "eventType": "<string>",
  "eventUrl": "<string>",
  "startDateTime": "2023-11-07T05:31:56Z"
}
'
{
  "createdAt": "2023-11-07T05:31:56Z",
  "customProperties": [
    {
      "dataSensitivity": "high",
      "isEncrypted": true,
      "isLargeValue": true,
      "name": "<string>",
      "persistenceTimestamp": 123,
      "requestId": "<string>",
      "selectedByUser": true,
      "selectedByUserTimestamp": 123,
      "source": "ACADEMY",
      "sourceId": "<string>",
      "sourceLabel": "<string>",
      "sourceMetadata": "<string>",
      "sourceUpstreamDeployable": "<string>",
      "sourceVid": [
        123
      ],
      "timestamp": 123,
      "unit": "<string>",
      "updatedByUserId": 123,
      "useTimestampAsPersistenceTimestamp": true,
      "value": "<string>"
    }
  ],
  "eventName": "<string>",
  "eventOrganizer": "<string>",
  "id": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z",
  "endDateTime": "2023-11-07T05:31:56Z",
  "eventCancelled": true,
  "eventCompleted": true,
  "eventDescription": "<string>",
  "eventType": "<string>",
  "eventUrl": "<string>",
  "objectId": "<string>",
  "startDateTime": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.jp/docs/llms.txt

Use this file to discover all available pages before exploring further.

Supported products

承認

Authorization
string
header
必須

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

パスパラメータ

externalEventId
string
必須

ボディ

application/json
customProperties
object[]
必須

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

eventName
string
必須

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

eventOrganizer
string
必須

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

externalAccountId
string
必須

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

externalEventId
string
必須

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

endDateTime
string<date-time>

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

eventCancelled
boolean

マーケティングイベントがキャンセルされたかどうかを示します。デフォルト値は「false」です

eventCompleted
boolean

マーケティングイベントが完了されたかどうかを示します。デフォルト値は「false」です

eventDescription
string

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

eventType
string

このイベントのタイプが説明されます。例:「WEBINAR」、「CONFERENCE」、「WORKSHOP」

eventUrl
string

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

startDateTime
string<date-time>

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

レスポンス

successful operation

createdAt
string<date-time>
必須

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

customProperties
object[]
必須

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

eventName
string
必須

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

eventOrganizer
string
必須

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

id
string
必須

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

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>

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

Last modified on April 13, 2026