Saltar al contenido principal
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>"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt

Use this file to discover all available pages before exploring further.

Parámetros de ruta

​
list_id
integer
requerido

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

Cuerpo

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.

Respuesta

200 - application/json

Successful response with update results

​
updated
integer[]
​
discarded
integer[]
​
invalidVids
integer[]
​
invalidEmails
string[]
Last modified on April 13, 2026