メインコンテンツへスキップ
POST
/
contacts
/
v1
/
lists
/
{list_id}
/
add
Add existing contacts to a list
curl --request POST \
  --url https://api.hubapi.com/contacts/v1/lists/{list_id}/add \
  --header 'Content-Type: application/json' \
  --data '
{
  "vids": [
    123
  ],
  "emails": [
    "<string>"
  ]
}
'
{
  "updated": [
    123
  ],
  "discarded": [
    123
  ],
  "invalidVids": [
    123
  ],
  "invalidEmails": [
    "<string>"
  ]
}

パスパラメータ

​
list_id
integer
必須

You need to include the ID for the list you're adding the contacts to.

ボディ

application/json
​
vids
integer[]

The contact IDs of the contacts that you're adding to the list. Up to 500 total contacts can be added in a single request.

​
emails
string[]

The email addresses of the contacts that you're adding to the list. Up to 500 total contacts can be added in a single request.

レスポンス

200 - application/json

Successful response with update results

​
updated
integer[]
​
discarded
integer[]
​
invalidVids
integer[]
​
invalidEmails
string[]
最終更新日 2026年4月13日