Lists

Upload new contact data into a list (RAW upload)

Creates new contacts from the supplied data and adds them to the list, the same path a CSV upload takes (no enrichment runs and no credits are spent). Every row becomes a new contact — there is no de-duplication against contacts already in the workspace, so retrying a call duplicates rows. Emails are stored as the primary email with status valid without verification, phones are normalised to E.164 (US assumed when no country code is given), and LinkedIn URLs are normalised to linkedin.com/in/<slug> so the contact can later be found with POST /business/contacts/resolve. The returned contactIds are the new rows' ids, usable with columns/{columnId}/values, enrich and crm-push. Up to 500 contacts per call.

Errors:

  • 404 LIST_NOT_FOUND — No list with that id is visible to the token owner.
  • 422 CONTACT_LIST_REQUIRED — The list is a company list; contact rows cannot be written into it.
  • 422 VALIDATION_FAILED — contacts missing/empty/over 500, a row with none of email/linkedinUrl/firstName/lastName, a malformed email, or an unknown key.
  • 429 RATE_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}/contacts

Request

  • Base URL: https://api.tryfuse.ai/api/v1
  • URL: https://api.tryfuse.ai/api/v1/business/lists/{listId}/contacts
  • Auth: HTTP basic

Path parameters

listIdstring required

24-character hex id of the list (from GET /business/lists).

Request body

Response

Success

addedCountinteger required
contactIdsstring[] required

Changes

No recorded changes to this operation across all 1 revision of this API.