Add Contact to Lists

POST

/v1/contacts/{id}/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.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Path Params

Query Params

Body Params application/jsonRequired

Example

{
    "data": [
        {
            "type": "list",
            "id": "contact_123"
        },
        {
            "type": "list",
            "id": "contact_456"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.leadfeeder.com/v1/contacts/3219787601/lists?account_id=123456' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "data": [
        {
            "type": "list",
            "id": "contact_123"
        },
        {
            "type": "list",
            "id": "contact_456"
        }
    ]
}'

Responses

🟢201Created

application/json

Contact successfully added to lists

Bodyapplication/json

Example

{
    "data": null,
    "meta": {
        "request_id": "abc123"
    }
}

🟠400Bad Request

🟠403Forbidden

🟠404Record Not Found

🟠429Too Many Requests

🔴500Server Error

🔴504Gateway Timeout

Modified at 2026-05-22 11:02:07

Search Contacts

Remove Contact from Lists