Hunch

API Reference

Settings & integrations

Read and update how Hunch delivers alerts, and check the connection status of your integrations.

Get notification settings

GET/settings/notifications

Returns the workspace's delivery settings and alert toggles.

Response
{
  "data": {
    "webhook_url": "https://hooks.example.com/hunch",
    "webhook_enabled": true,
    "slack_channel": "#signals",
    "slack_enabled": true,
    "notify_realtime": true,
    "notify_suggested": true
  }
}

Update notification settings

PUT/settings/notifications

Update any subset of the fields below.

webhook_urlstring | nulloptional

Destination for webhook deliveries. Null to clear.

webhook_enabledbooleanoptional

Enable or disable webhook delivery.

slack_channelstringoptional

Slack channel to post to.

slack_enabledbooleanoptional

Enable or disable Slack delivery.

notify_realtimebooleanoptional

Alerts on active accounts.

notify_suggestedbooleanoptional

Alerts on new suggested accounts.

Request
curl -X PUT https://usehunch.co/api/v1/settings/notifications \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "slack_channel": "#revenue-signals", "notify_suggested": false }'

Returns the full, updated settings object.

Integration status

GET/integrations

Returns the connection status for each integration: CRMs (HubSpot and Salesforce), Slack, the notification webhook, webhook export destinations, and MCP. crm keeps the original single-connection shape (the first connected CRM); crms lists every connected provider.

Response
{
  "data": {
    "crm": { "connected": true, "provider": "hubspot", "connected_at": "2026-06-01T..." },
    "crms": [
      { "provider": "hubspot", "connected_at": "2026-06-01T..." },
      { "provider": "salesforce", "connected_at": "2026-06-14T..." }
    ],
    "slack": { "connected": true, "channel": "#signals" },
    "webhook": { "enabled": true, "url": "https://hooks.example.com/hunch" },
    "webhook_destinations": { "count": 2 },
    "mcp": { "enabled": true }
  }
}
PreviousWebhook exportNext Workspace & members