curl --request POST \
--url https://api.tryfuse.ai/api/v1/business/imports/{importId}/commit \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"listId": "<string>",
"listName": "<string>",
"mapping": {}
}
'import requests
url = "https://api.tryfuse.ai/api/v1/business/imports/{importId}/commit"
payload = {
"listId": "<string>",
"listName": "<string>",
"mapping": {}
}
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({listId: '<string>', listName: '<string>', mapping: {}})
};
fetch('https://api.tryfuse.ai/api/v1/business/imports/{importId}/commit', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"import": {
"importId": "dXBsb2Fkcy82OGExZjIwYjljNDFkMjAwMTRiM2U5MDEvM2Y2ZjBlMmEtOGQ0Yi00ZTFhLTk3YzItNWQ4YjFmMGUyYTdjLmNzdg",
"listId": "68a1f20b9c41d20014b3e901",
"jobId": "3f6f0e2a-8d4b-4e1a-97c2-5d8b1f0e2a7c"
}
}{
"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>"
}
}Commit an import into a list
Commits a parsed import into a list: append to an existing one with listId, or name the destination with listName (an existing list with that exact, case-insensitive name is reused, otherwise it is created). mapping confirms the column mapping (source header -> standard field label, e.g. {"fname": "First Name"}; headers already named like a standard field need no entry, and the suggestedMapping from POST /business/imports can be sent back as-is — the null it carries for an unmatched header is accepted and leaves that header unmapped). enrich runs enrichment on the imported rows in the same job (none = raw rows, email/phone/phone_and_email = the waterfall, demographics = resolve to canonical contacts; billed like POST /business/lists/{listId}/enrich). Async: 202. jobId is an opaque orchestration reference and is NOT pollable — poll GET /business/lists/{listId} until completionStatus leaves processing.
Errors:
404IMPORT_NOT_FOUND— importId does not decode to an upload of the token owner.404LIST_NOT_FOUND— The destination listId is unknown or not owned.409LIST_NAME_AMBIGUOUS— More than one list carries listName — reference the destination by id.422LIST_NAME_RESERVED— listName is a system/dynamic list title and cannot be a destination.422VALIDATION_FAILED— Neither or both of listId/listName, an unknown body key, an invalid enrich mode, or a malformed mapping.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.
curl --request POST \
--url https://api.tryfuse.ai/api/v1/business/imports/{importId}/commit \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"listId": "<string>",
"listName": "<string>",
"mapping": {}
}
'import requests
url = "https://api.tryfuse.ai/api/v1/business/imports/{importId}/commit"
payload = {
"listId": "<string>",
"listName": "<string>",
"mapping": {}
}
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({listId: '<string>', listName: '<string>', mapping: {}})
};
fetch('https://api.tryfuse.ai/api/v1/business/imports/{importId}/commit', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"import": {
"importId": "dXBsb2Fkcy82OGExZjIwYjljNDFkMjAwMTRiM2U5MDEvM2Y2ZjBlMmEtOGQ0Yi00ZTFhLTk3YzItNWQ4YjFmMGUyYTdjLmNzdg",
"listId": "68a1f20b9c41d20014b3e901",
"jobId": "3f6f0e2a-8d4b-4e1a-97c2-5d8b1f0e2a7c"
}
}{
"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
The importId returned by POST /business/imports (or /business/imports/presign) that identifies the uploaded file.
8 - 800Body
24-character hex id of an existing contact list to append the rows to; mutually exclusive with listName, and an unknown or non-owned id answers 404 LIST_NOT_FOUND.
Name of the destination contact list (1-255 characters): an existing list with this exact name (case-insensitive) is reused, otherwise it is created; mutually exclusive with listId. Two lists sharing the name answer 409 LIST_NAME_AMBIGUOUS and reserved system titles answer 422 LIST_NAME_RESERVED.
1 - 255Column mapping from source column header to target field, e.g. {"fname": "First Name"} (up to 200 entries). Each key is a column header spelled exactly as it appears in the file (the headers of the import preview). Each value is one of exactly these 21 target labels, spelled and cased exactly like this: Full Name, First Name, Last Name, LinkedIn URL, Company, Company Domain, Job Title, Job Level, Department, Industry, Country, State, City, Email, Phone — plus six aliases, each read only when the label it follows is missing or empty: Company Name (after Company), Mobile Phone (after Phone), Seniority then Level (after Job Level), and linkedinUrl then linkedin (after LinkedIn URL). Map to the primary label where you can. A label outside those 21 is ACCEPTED and then silently drops that column — no error, no custom column. Headers that already match a label case-insensitively (email, first_name, title, domain) need no entry, a header with no target carries null and is ignored — so the suggestedMapping from POST /business/imports can be sent back unchanged — and when two headers name the same target only the last one is used.
Enrichment to run on the imported rows: none (default, rows saved exactly as uploaded), email, phone or phone_and_email (the enrichment waterfall, billed per contact processed) or demographics (resolve rows to canonical contacts, 2 credits per resolved contact).
none, email, phone, phone_and_email, demographics Response
Success
Show child attributes
Show child attributes