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:

  • 404 LIST_NOT_FOUND — No list with that id is visible to the token owner.
  • 422 VALIDATION_FAILED — contactIds missing, empty, over 5000 entries, or containing a non-24-hex id.
  • 429 RATE_LIMITED — The lists rate bucket is exhausted.

Requires one of the following token scopes: lists.

post/business/lists/{listId}/members

Request

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

Path parameters

listIdstring required

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

Request body

contactIdsstring[] required

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.

Response

Success

submittedCountinteger required
addedCountinteger required

Changes

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