メインコンテンツへスキップ
POST
/
marketing
/
v3
/
marketing-events
/
attendance
/
{externalEventId}
/
{subscriberState}
/
email-create
マーケティングイベント外部IDを使用してEメール別に参加者を記録
curl --request POST \
  --url https://api.hubapi.com/marketing/v3/marketing-events/attendance/{externalEventId}/{subscriberState}/email-create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "contactProperties": {},
      "email": "<string>",
      "interactionDateTime": 123,
      "properties": {}
    }
  ]
}
'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "email": "<string>",
      "vid": 123
    }
  ],
  "startedAt": "2023-11-07T05:31:56Z",
  "status": "CANCELED",
  "errors": [
    {
      "category": "<string>",
      "context": {},
      "errors": [
        {
          "message": "<string>",
          "code": "<string>",
          "context": "{missingScopes=[scope1, scope2]}",
          "in": "<string>",
          "subCategory": "<string>"
        }
      ],
      "links": {},
      "message": "<string>",
      "status": "<string>",
      "id": "<string>",
      "subCategory": {}
    }
  ],
  "links": {},
  "numErrors": 123,
  "requestedAt": "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.

パスパラメータ

externalEventId
string
必須
subscriberState
string
必須

クエリパラメータ

externalAccountId
string

ボディ

application/json
inputs
object[]
必須

作成または更新するマーケティングイベントの詳細のリスト

レスポンス

successful operation

completedAt
string<date-time>
必須

リクエストの処理が完了した時点を表すタイムスタンプ

results
object[]
必須
startedAt
string<date-time>
必須

リクエストの処理が開始された時点を表すタイムスタンプ

status
enum<string>
必須

リクエスト処理のステータス

利用可能なオプション:
CANCELED,
COMPLETE,
PENDING,
PROCESSING
errors
object[]

リクエストの結果

numErrors
integer<int32>

処理中に発生したエラーの数

requestedAt
string<date-time>

リクエストが行われた時点を表すタイムスタンプ

Last modified on March 20, 2026