v3

latestOpenAPI 3.1.1mit2026-07-3165481.5 MB
Web Visits
v1

Create a Custom Feed

Create a new custom feed for the given account.

:::info Requires the web_visits:write OAuth2 scope. :::

post/v1/web-visits/custom-feeds

Query parameters

account_idstring required

The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.

Request body

Example request

{
  "data": {
    "type": "custom_feed",
    "attributes": {
      "name": "All companies",
      "notifications": [
        {
          "sending_interval": "day",
          "medium": "email",
          "user_id": 12345
        }
      ],
      "advanced_filters": {
        "type": "group",
        "operator": "and",
        "items": [
          {
            "type": "group",
            "operator": "or",
            "negated": false,
            "items": []
          },
          {
            "type": "group",
            "operator": "or",
            "negated": true,
            "items": []
          }
        ]
      }
    }
  }
}

Response

Success

Example response

{
  "data": {
    "type": "custom_feed",
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "attributes": {
      "name": "All companies",
      "created_at": "2026-01-15T10:30:00.000Z",
      "updated_at": "2026-01-20T14:00:00.000Z",
      "deletable": true,
      "viewable": true,
      "notifications": [
        {
          "sending_interval": "day",
          "medium": "email",
          "user_id": 12345
        }
      ],
      "advanced_filters": {
        "type": "group",
        "operator": "and",
        "items": [
          {
            "type": "filter",
            "field": "country_code",
            "operator": "includes",
            "display_value": "Germany"
          }
        ]
      }
    },
    "relationships": {
      "created_by": {
        "id": "12345"
      },
      "folder": {
        "id": "42",
        "type": "custom_feed_folder"
      }
    }
  },
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}