# Add handles to a specific exclusion list

Appends handles to the specific exclusion list. Handles are normalised automatically (lowercased, @ stripped, full URLs reduced to just the handle). Adding handles does not filter search on its own — apply the list to a search by passing its ID in exclude_list in the Discovery or Similar Creators filters. Returns the updated list object. This operation is free — it does not consume credits.

Endpoint: POST /public/v1/discovery/exclusion-lists/{list_id}/entries/
Version: 1.0.0
Security: Bearer

## Path parameters:

  - `list_id` (integer, required)
    The exclusion list's unique identifier.

## Request fields (application/json):

  - `handles` (array, required)
    Handles to add to or remove from the list. Normalized automatically (lowercased, @ stripped, URLs parsed to extract the handle).

## Response 200 fields (application/json):

  - `id` (integer, required)
    The exclusion list's unique identifier.
    Example: 42

  - `name` (string, required)
    Human-readable name of the exclusion list.
    Example: "Blocklist Q4"

  - `platform` (string, required)
    The social media platform this list applies to.
    Example: "instagram"

  - `is_default` (boolean, required)
    Whether this is the team's default list for the platform.

  - `handle_count` (integer, required)
    Number of handles currently in the list.
    Example: 3

  - `created_at` (string, required)
    When the list was created.
    Example: "2026-01-15T09:30:00Z"

  - `updated_at` (string, required)
    When the list was last modified.
    Example: "2026-01-20T14:05:00Z"


## Response 400 fields

## Response 401 fields

## Response 422 fields