メインコンテンツへスキップ
POST
/
webhooks
/
v3
/
{appId}
/
subscriptions
/
batch
/
update
イベント配信登録をバッチ作成
curl --request POST \
  --url https://api.hubapi.com/webhooks/v3/{appId}/subscriptions/batch/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "active": true,
      "id": 12
    }
  ]
}
'
{
  "completedAt": "2020-04-17T02:19:26.283Z",
  "results": [
    {
      "active": true,
      "createdAt": "2019-06-06T16:56:16.652Z",
      "eventType": "contact.propertyChange",
      "id": "1234",
      "propertyName": "firstname",
      "updatedAt": "2019-08-06T16:56:16.652Z"
    },
    {
      "active": false,
      "createdAt": "2019-06-06T16:56:16.652Z",
      "eventType": "contact.create",
      "id": "4567",
      "updatedAt": "2019-08-06T16:56:16.652Z"
    }
  ],
  "startedAt": "2020-04-17T02:19:26.256Z",
  "status": "COMPLETE"
}

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.

パスパラメータ

appId
integer<int32>
必須

ターゲットアプリのID。

ボディ

application/json

Updated details for the specified subscriptions.

inputs
object[]
必須

SubscriptionBatchUpdateRequestオブジェクトの配列。各オブジェクトは、バッチ処理における特定のWebhook配信登録の更新済み設定を表します。

レスポンス

successful operation

completedAt
string<date-time>
必須

バッチ処理が完了した時刻のタイムスタンプ(ISO 8601形式)。

results
object[]
必須

バッチ処理で正常に処理されたWebhook配信登録が含まれる配列。

startedAt
string<date-time>
必須

バッチ処理が開始された時刻のタイムスタンプ(ISO 8601形式)。

status
enum<string>
必須

バッチ処理のステータス。取り得る値は「PENDING」、「PROCESSING」、「CANCELED」、または「COMPLETE」です。

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

関連リソースまたは処理のURLが含まれるオブジェクト。

requestedAt
string<date-time>

バッチ処理が要求された時刻のタイムスタンプ(ISO 8601形式)。

Last modified on April 13, 2026