メインコンテンツへスキップ
POST
/
events
/
v3
/
send
カスタムイベント完了を送信
curl --request POST \
  --url https://api.hubapi.com/events/v3/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "eventName": "<string>",
  "properties": {},
  "email": "<string>",
  "objectId": "<string>",
  "occurredAt": "2023-11-07T05:31:56Z",
  "utk": "<string>",
  "uuid": "<string>"
}
'
This response has no body data.
次のいずれかの製品またはそれ以上が必要です。
Marketing HubMarketing Hub -Enterprise
Sales HubSales Hub -Enterprise
Service HubService Hub -Enterprise
Content HubContent Hub -Enterprise

認証

​
Authorization
string
header
必須

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

ボディ

application/json
​
eventName
string
必須

イベントの内部名（「pe_eventName」）。[イベント定義API]（https://developers.hubspot.com/docs/reference/api/analytics-and-events/custom-events/custom-event-definitions#get-%2Fevents%2Fv3%2Fevent-definitions）を使用するか、[HubSpotのUI]（https://knowledge.hubspot.com/reports/create-custom-behavioral-events-with-the-code-wizard#find-internal-name）で取得できます。

​
properties
object
必須

更新するイベントプロパティー。キーと値ペアの形式になります（プロパティーの内部名とプロパティー値）。[HubSpotのデフォルトのイベントプロパティー]（https://developers.hubspot.com/docs/guides/api/analytics-and-events/custom-events/custom-event-definitions#hubspot-s-default-event-properties）についてもっと詳しく。

​
email
string

訪問者のEメールアドレス。イベントデータをCRMレコードに関連付けるために使用されます。

​
objectId
string

イベントを完了したオブジェクトのID（例えば、コンタクトIDや訪問者ID）。

​
occurredAt
string<date-time>

このイベントが発生した時刻。これが設定されていない場合、現在の時刻が使用されます。

​
utk
string

訪問者のユーザートークン。イベントデータをCRMレコードに関連付けるために使用されます。

​
uuid
string

固有IDをイベント完了に割り当てるには汎用一意識別子を含めます。HubSpotと他の外部システム間でデータを照合する場合に有用です。

レスポンス

Last modified on December 8, 2025