DiviDen Integration Guide

Connect Google services, external tools, and custom webhooks to DiviDen.

Google Integration (Recommended)

The fastest way to connect email, calendar, and file storage. DiviDen uses Google OAuth to sync your Gmail, Google Calendar, and Google Drive directly — no webhooks or third-party tools needed.

Quick Start

  1. Go to Settings → Integrations
  2. Click Connect Google
  3. Authorize Gmail, Calendar, and Drive access
  4. DiviDen syncs your data automatically — emails, events, and files appear in the dashboard
Self-hosted? You need to configure your own Google Cloud OAuth credentials first. See the Google OAuth Setup Guide →

Gmail

Read, send, compose

Calendar

Full read + write

Drive

Read-only file sync

Multi-account support: Connect up to 3 Google accounts per identity. Calendar and Drive views show per-account tabs and color-coded filters.
Drive Content Fetch (v2.5.98): The Discuss button on Google Drive files now fetches live document text via the Google Drive API. Google Docs export as plain text, Sheets as CSV, Slides as plain text. Content is cached locally after the first fetch. Binary files (PDFs, images) show metadata only. See Developer Docs for the full API spec.

SMTP / IMAP (Alternative)

If you don't use Google, connect any email provider via SMTP/IMAP. Go to Settings → Integrations → + SMTP and provide your server credentials.

Webhooks

For services beyond Google (Slack, GitHub, Notion, CRMs, etc.), DiviDen uses a webhook-first approach. Create webhook endpoints that receive data from platforms like Zapier, Make, n8n, or direct API calls.

Quick Start

  1. Go to Settings → Integrations
  2. Click + New Webhook and choose a type
  3. Copy the webhook URL and secret
  4. Configure your external service to POST data to the URL
  5. DiviDen auto-learns your payload structure via LLM and maps fields automatically
  6. Data flows into Calendar, Inbox, Recordings, CRM, and Queue

Tip: You can also ask Divi to set up webhooks and API keys directly from chat. Just say "set up a calendar webhook" and Divi will create it for you.

Webhook Types

Calendar

/api/webhooks/calendar

Creates queue items from events, adds attendees as contacts

Email

/api/webhooks/email

Creates contacts from senders, adds email as queue notification

Transcript

/api/webhooks/transcript

Creates kanban cards with checklists from action items

Generic

/api/webhooks/generic

Creates a queue item with the payload data

Authentication

Query Parameter (Simplest)

POST /api/webhooks/calendar?webhookId=ID&secret=YOUR_SECRET

Header-Based Secret

X-Webhook-Secret: YOUR_SECRET

HMAC-SHA256 Signature

X-Webhook-Signature: sha256=COMPUTED_HMAC_HEX

Payload Examples

Calendar Event

{
  "summary": "Team Standup",
  "description": "Daily standup meeting",
  "start": { "dateTime": "2025-01-15T09:00:00Z" },
  "end": { "dateTime": "2025-01-15T09:30:00Z" },
  "attendees": [
    { "email": "alice@example.com", "displayName": "Alice Johnson" }
  ]
}

Email Notification

{
  "from": { "name": "Jane Doe", "email": "jane@example.com" },
  "subject": "Project Update",
  "body": "Hi, here is the latest update..."
}

Meeting Transcript

{
  "title": "Q1 Planning Meeting",
  "transcript": "Discussion about Q1 goals...",
  "actionItems": [
    "Review budget proposal by Friday",
    "Schedule follow-up with engineering"
  ],
  "participants": [
    { "name": "John Doe", "email": "john@example.com" }
  ]
}

Generic

{
  "title": "New Form Submission",
  "description": "Lead from website",
  "data": { "name": "Alex Brown", "email": "alex@example.com" }
}

Zapier Examples

Google Calendar → DiviDen

  1. Trigger: Google Calendar → New Event
  2. Action: Webhooks by Zapier → POST
  3. URL: Your DiviDen calendar webhook URL
  4. Map: summary, description, start.dateTime, end.dateTime, attendees

Gmail → DiviDen

  1. Trigger: Gmail → New Email
  2. Action: Webhooks by Zapier → POST
  3. URL: Your DiviDen email webhook URL
  4. Map: from.name, from.email, subject, body

Testing with cURL

curl -X POST "YOUR_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d '{
    "summary": "Test Meeting",
    "start": {"dateTime": "2025-01-15T10:00:00Z"},
    "attendees": [{"email": "test@example.com"}]
  }'

Auto-Learn Field Mapping

When a webhook payload arrives for the first time, DiviDen's LLM analyzes the structure and automatically maps fields to the correct internal format. You can view, edit, or re-learn mappings in Settings → Integrations → Field Mapping.

Auto-Learned

LLM analyzed and mapped fields automatically

Manual

You manually specified field paths

Mixed

Combination of auto-learned and manual overrides

None

No mapping yet — send a test payload to trigger

Capabilities — Bubble Store

Capabilities are modular skill packs your agent can install to gain new abilities — from drafting emails to generating invoices. They live in Settings → Integrations → Capabilities.

20 Seeded Capabilities

Across 7 categories: productivity, communication, finance, HR, operations, sales, custom.

Integration-Gated

Some capabilities require a connected integration (email, calendar, CRM, etc.) before install.

You can also create custom capabilities with your own prompt template, category, and integration requirement. Pricing supports free and one_time models.

Full API reference: see the Capabilities API section in Developer Docs.

Agent API v2

External AI agents can interact with your DiviDen instance via the Agent API. Generate a Bearer token in Settings → API Keys, then use the /api/v2/* endpoints.

GET/POST/api/v2/kanbanList or create Kanban cards
GET/POST/api/v2/contactsList or create contacts
GET/POST/api/v2/queueList or dispatch queue items
GET/POST/api/v2/docsAPI documentation (OpenAPI spec)
POST/api/v2/shared-chat/sendSend a message to Divi
GET/api/v2/shared-chat/streamStream Divi's response (SSE)
curl -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  YOUR_DIVIDEN_URL/api/v2/kanban

Federation & Connections

Looking to connect with other DiviDen instances, self-host the open source version, or build an agent that speaks DAWP? See the fullFederation Guide →

Project Invites as Divi→Divi Comms (v2.3.1)

Project invites are now first-class AgentRelay + CommsMessage events with a duplicate guard and clean reinvite path. For the full recipe — payload shape, federation delivery, Accept/Decline wiring, and event listeners — see theProject Invites Integration Guide →

Download a plain-text copy of this page

Last updated: May 28, 2026

Built by DiviDen — the individual-first operating system