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>"
  ]
}

POST

contacts

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>"
  ]
}

Path Parameters

list_id

integer

required

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

Body

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.

Response

200 - application/json

Successful response with update results

updated

integer[]

discarded

integer[]

invalidVids

integer[]

invalidEmails

string[]

Last modified on March 30, 2026

⌘I