Build a company list from a contact list's companies
curl --request POST \
--url https://api.tryfuse.ai/api/v1/business/lists/{listId}/derive-company-list \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>"
}
'import requests
url = "https://api.tryfuse.ai/api/v1/business/lists/{listId}/derive-company-list"
payload = { "name": "<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({name: '<string>'})
};
fetch('https://api.tryfuse.ai/api/v1/business/lists/{listId}/derive-company-list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"list": {
"id": "68a1f20b9c41d20014b3e977",
"name": "Q3 fintech companies"
},
"sourceContacts": 412
}{
"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
Build a company list from a contact list's companies
Builds a new company list from the companies the contact list’s rows belong to. Async: 202 returns the created list (in processing state) and sourceContacts, the number of contacts examined; poll GET /business/lists/{listId} on the new id until completionStatus is complete. A source list still being built answers 409 LIST_PROCESSING — retry once its own completionStatus leaves processing.
Errors:
404LIST_NOT_FOUND— No source list with that id is visible to the token owner.409LIST_NAME_TAKEN— A list already carries the requested name.409LIST_PROCESSING— The source list is still being built; retry once its completionStatus leaves processing.422CONTACT_LIST_REQUIRED— The source list is a company list; companies are derived from a contact list’s rows.422LIST_EMPTY— The source list has no contacts to derive companies from.422INVALID_REQUEST— CRM rejected the request for a reason outside the mapped set.422VALIDATION_FAILED— name missing/blank or over 255 characters, or an unknown body key.429RATE_LIMITED— The lists rate bucket (120 requests/minute, 10,000/day per token owner) is exhausted.
Requires one of the following token scopes: lists.
POST
/
business
/
lists
/
{listId}
/
derive-company-list
Build a company list from a contact list's companies
curl --request POST \
--url https://api.tryfuse.ai/api/v1/business/lists/{listId}/derive-company-list \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>"
}
'import requests
url = "https://api.tryfuse.ai/api/v1/business/lists/{listId}/derive-company-list"
payload = { "name": "<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({name: '<string>'})
};
fetch('https://api.tryfuse.ai/api/v1/business/lists/{listId}/derive-company-list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"list": {
"id": "68a1f20b9c41d20014b3e977",
"name": "Q3 fintech companies"
},
"sourceContacts": 412
}{
"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
Name for the new company list (1-255 characters); a name already in use answers 409 LIST_NAME_TAKEN.
Required string length:
1 - 255