Update View

curl --request PATCH \
  --url https://api.openfunnel.dev/api/v1/views/{view_id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "name": "<string>",
  "filters": {},
  "is_default": true,
  "slack_notifications": {
    "enabled": true,
    "target": "dm",
    "channel_id": "<string>"
  },
  "webhook_notifications": {
    "enabled": true,
    "url": "<string>"
  },
  "crm_assignment": {
    "enabled": true,
    "assignee_id": "<string>",
    "assignee_ids": [
      "<string>"
    ],
    "override_owner_ids": [
      "<string>"
    ]
  },
  "amplemarket_sequencing": {
    "enabled": true,
    "sequence_id": "<string>"
  }
}
'

{
  "view": {
    "id": "<string>",
    "user_id": "<string>",
    "name": "<string>",
    "filters": {},
    "is_default": false,
    "action_config": {},
    "last_notified_insight_id": 123,
    "last_notification_at": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>"
  },
  "webhook_secret": "<string>",
  "message": "<string>"
}

Views

Update View

Partially update a view. Only the fields present in the request are modified - omitted fields keep their current value.

Semantics:

Sending a config object with enabled: false turns that action off (e.g. {"webhook_notifications": {"enabled": false}} removes the webhook). Omitting the object leaves it unchanged.
filters replaces the view’s filters entirely (it is not merged). To change a single filter, GET the view first, edit the returned filters object, and send the whole thing back. Use the field names from GET /api/v2/account/filters.
Changing the webhook URL rotates the signing secret; the new webhook_secret is returned once in the response. Re-sending the same URL keeps the existing secret.
Enabling CRM assignment - or changing filters while it is enabled - starts a one-time background sync of the currently-matching accounts.

Channel, user, and sequence IDs come from GET /api/v1/views/options. Errors: 400 for invalid config, 404/403 for missing or foreign views, 409 on a name conflict.

PATCH

api

views

{view_id}

Update View

curl --request PATCH \
  --url https://api.openfunnel.dev/api/v1/views/{view_id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "name": "<string>",
  "filters": {},
  "is_default": true,
  "slack_notifications": {
    "enabled": true,
    "target": "dm",
    "channel_id": "<string>"
  },
  "webhook_notifications": {
    "enabled": true,
    "url": "<string>"
  },
  "crm_assignment": {
    "enabled": true,
    "assignee_id": "<string>",
    "assignee_ids": [
      "<string>"
    ],
    "override_owner_ids": [
      "<string>"
    ]
  },
  "amplemarket_sequencing": {
    "enabled": true,
    "sequence_id": "<string>"
  }
}
'

{
  "view": {
    "id": "<string>",
    "user_id": "<string>",
    "name": "<string>",
    "filters": {},
    "is_default": false,
    "action_config": {},
    "last_notified_insight_id": 123,
    "last_notification_at": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>"
  },
  "webhook_secret": "<string>",
  "message": "<string>"
}

Headers

X-API-Key

string

required

Path Parameters

view_id

string

required

The view's ID (returned by the create and list endpoints)

Body

application/json

Request to partially update a saved view. Omitted fields are left unchanged.

name

string | null

New view name (unique per user)

Minimum string length: 1

filters

Filters · object

Replacement account filters using the field names from GET /api/v2/account/filters (e.g. funding_stage_include, country_include). Replaces the view's filters entirely.

is_default

boolean | null

Set or unset this view as the default view

slack_notifications

ViewSlackConfig · object

Slack notification settings for a view.

Show child attributes

webhook_notifications

ViewWebhookConfig · object

Webhook notification settings for a view.

Show child attributes

crm_assignment

ViewCrmAssignment · object

CRM assignment settings for a view.

The CRM type (Salesforce or HubSpot) is detected automatically from the connected CRM integration - it does not need to be specified.

Show child attributes

amplemarket_sequencing

ViewAmplemarketConfig · object

Amplemarket sequencing settings for a view.

Show child attributes

Response

Successful Response

Response for create / get / update view endpoints.

view

SavedViewItem · object

required

Single saved view owned by a user.

Show child attributes

webhook_secret

string | null

Webhook signing secret - returned only once, when a webhook is configured or its URL changes. Store it securely.

message

string | null

Delete View Get View Alerts

⌘I