# Create exclusion list

Creates a new specific exclusion list for the given platform and returns its id. Use specific lists for handles you want to apply selectively; for a standing, always-on blocklist use the platform's default list instead. After creating a list, add handles via /exclusion-lists/{list_id}/entries/, then apply it to a search by passing its ID in exclude_list in the Discovery or Similar Creators filters. This operation is free — it does not consume credits.

Endpoint: POST /public/v1/discovery/exclusion-lists/
Version: 1.0.0
Security: Bearer

## Request fields (application/json):

  - `name` (string, required)
    Human-readable name for the new exclusion list.

  - `platform` (string, required)
    The social media platform this list applies to.
    Enum: "instagram", "youtube", "tiktok", "twitch", "twitter", "onlyfans"

## Response 201 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