v3

OpenAPI 3.1.1mit2026-07-3165481.5 MB
Companies
v1

Add Company to Lists

Allows the addition of this company 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 company to lists does not consume credits.

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

post/v1/companies/{id}/lists

Path parameters

idstring required

The company'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

Company successfully added to lists

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