v3

OpenAPI 3.1.1mit2026-07-3165481.5 MB
Contacts
v1

Add Contact to Lists

Allows the addition of this contact to one or more lists. Since lists are a separate entity, the IDs that you must pass in this endpoint come from the Retrieve Lists and Get List Details endpoints.

Credit Note: Adding a contact to lists does not consume credits.

:::info Requires the contacts:write OAuth2 scope. :::

post/v1/contacts/{id}/lists

Path parameters

idstring required

The contact's ID. Note that the older string-based ID format continues to be supported.

Query parameters

account_idstring required

The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.

Request body

Response

Contact successfully added to lists

{"stackTrail":"paths:/v1/contacts/{id}/lists:post:responses:201:content:application/json:schema:properties:data","oasType":"schema","type":"unknown"}