Add existing contacts to a list (by id)
curl --request POST \
--url https://api.tryfuse.ai/api/v1/business/lists/{listId}/members \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"contactIds": [
"<string>"
]
}
'import requests
url = "https://api.tryfuse.ai/api/v1/business/lists/{listId}/members"
payload = { "contactIds": ["<string>"] }
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({contactIds: ['<string>']})
};
fetch('https://api.tryfuse.ai/api/v1/business/lists/{listId}/members', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"submittedCount": 3,
"addedCount": 2
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}Lists
Add existing contacts to a list (by id)
Adds existing contacts to the list by id (row ids from GET /business/lists/{listId}/rows on another list, or POST /business/contacts/resolve). Idempotent: contacts already in the list are skipped, so addedCount (net new members) can be lower than submittedCount. Up to 5,000 ids per call; no credits are spent.
Errors:
404LIST_NOT_FOUND— No list with that id is visible to the token owner.422VALIDATION_FAILED— contactIds missing, empty, over 5000 entries, or containing a non-24-hex id.429RATE_LIMITED— The lists rate bucket is exhausted.
Requires one of the following token scopes: lists.
POST
/
business
/
lists
/
{listId}
/
members
Add existing contacts to a list (by id)
curl --request POST \
--url https://api.tryfuse.ai/api/v1/business/lists/{listId}/members \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"contactIds": [
"<string>"
]
}
'import requests
url = "https://api.tryfuse.ai/api/v1/business/lists/{listId}/members"
payload = { "contactIds": ["<string>"] }
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({contactIds: ['<string>']})
};
fetch('https://api.tryfuse.ai/api/v1/business/lists/{listId}/members', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"submittedCount": 3,
"addedCount": 2
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}Authorizations
Your API token (af_…) as the Basic-auth username, with an empty password.
Path Parameters
24-character hex id of the list (from GET /business/lists).
Body
application/json
Contact ids (24-character hex, 1-5000 per call) to add to or remove from the list; ids already in the list are ignored on add.
Required array length:
1 - 5000 elements24-character hex id of a contact (the row id from GET /business/lists/{listId}/rows).