# Salvar filtro de prospecção

Salva um conjunto de filtros para reutilização posterior.

Permite armazenar filtros complexos de pessoas ou empresas para uso recorrente.

Endpoint: POST /prospection/filters
Version: 1.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `filter_name` (string, required)
    Nome do filtro
    Example: "Executivos SP"

  - `filter_type` (integer, required)
    Tipo de filtro (1=pessoas, 2=empresas)
    Enum: 1, 2

  - `data` (object, required)
    Objeto contendo os filtros (mesma estrutura usada em /persons/prospect ou /company/prospect)
    Example: {"cities":["São Paulo - SP"],"professions":["999999"],"age":{"min_age":30,"max_age":50}}

## Response 200 fields (application/json):

  - `filter_id` (integer)
    Example: 123

  - `message` (string)
    Example: "Filtro salvo com sucesso"

## Response 400 fields (application/json):

  - `error` (object)

  - `error.code` (string)
    Example: "no credits"

  - `error.description` (string)
    Example: "Você não possui saldo suficiente, disponível 0"

## Response 403 fields (application/json):

  - `error` (string)
    Example: "Invalid token"