Skip to main content

Filters API

Manage saved filters for the active Organizational Unit. Saved filters let your team quickly apply commonly-used filter criteria to lead and event lists.

GET /filters​

List all saved filters.

Response​

200 OK

{
  "filters": [
    {
      "id": "filter-123",
      "name": "Hot Leads This Week",
      "criteria": {
        "min_score": 75,
        "last_active": "7d"
      },
      "created_at": "2025-01-15T10:00:00Z"
    }
  ]
}

Example​

curl -X GET "https://api.leadvibe.com/filters" \
  -H "Authorization: Bearer <token>"

POST /filters​

Create a new saved filter.

Request Body​

{
  "name": "Enterprise Hot Leads",
  "criteria": {
    "min_score": 75,
    "event_type": "demo_request"
  }
}

Response​

201 Created

Returns the created filter.

Example​

curl -X POST "https://api.leadvibe.com/filters" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Enterprise Hot Leads",
    "criteria": {"min_score": 75, "event_type": "demo_request"}
  }'

Common Errors​

StatusMeaningSolution
400Bad RequestMissing filter name or invalid criteria
401UnauthorizedCheck authentication token

Notes​

  • Filters are OU-scoped to the active Organizational Unit
  • Saved filters are shared across team members in the same OU