Skip to content

Integrations ​

DURUM.ai connects to your existing tools to centralize your leads, bookings, sales, payments and ad spend. Everything happens in Settings → Integrations: each tool has a card with a Connect button, then a Configuration button once connected.


Catalog ​

The catalog below is the one shown in the app, grouped by category. "Connection mode" tells you what you do: authorize in one click (OAuth), paste an API key, or copy a webhook URL into the tool.

Accounting ​

IntegrationConnection modeEvents capturedGuide
Zoho BooksOAuth, then webhooks to copy into Zoho Books (guide in the app); sync every 6 hoursPayments, invoicesZoho Books
QuickBooksOAuth shown in the app, but no QuickBooks event is processed yet: do not rely on this connector for your numbersnoneAsk your account manager

CRM ​

On the Discovery plan, one CRM connection is active at a time (error plan_free_one_crm beyond that). Paid tiers have no such limit.

IntegrationConnection modeEvents capturedGuide
GoHighLevelNative OAuth (sub-account choice); no webhook to create; classification of forms, calendars and pipelinesLeads, applications, bookings, no-shows, sales (Won opportunity in a selected pipeline)GHL
PipedriveOAuth; webhooks created automaticallyLeads (new contact), sales (deal won), losses (deal lost), bookings (meeting activity)Pipedrive
iClosedAPI key (Business or Enterprise plan), then 4 webhooks to copy into iClosed (guide in the app); can push your attribution back to iClosedLeads (contact created), applications (qualified contact), bookings (call booked), no-shows, sales (WON outcome), losses (NO_SALE outcome), payments (transactions), refundsiClosed

Forms ​

IntegrationConnection modeEvents capturedGuide
TypeformOAuth; webhooks created automatically; classification of each form (lead, application, ignore)Leads, applicationsTypeform

Funnels ​

IntegrationConnection modeEvents capturedGuide
ClickFunnelsAPI key + subdomain; webhooks created automatically; classification of each funnelLeads (form submissions), applications (per funnel mapping), sales (one-time orders)ClickFunnels

Scheduling ​

IntegrationConnection modeEvents capturedGuide
CalendlyOAuth; classification of each event type; sync every 15 minutesBookings, no-showsCalendly

Advertising ​

IntegrationConnection modeData capturedGuide
Meta AdsOAuth only; choice of ad account, Page and pixelSpend per ad per day (hourly sync), creatives; Conversions APIMeta Ads
Google AdsOAuth; choice of customer accountSpend per ad (hourly sync); conversion uploadGoogle Ads
TikTok AdsTikTok OAuth; choice of account, identity and pixelSpend per ad (hourly sync); conversion uploadTikTok Ads
ChatGPT AdsAPI key (issued in OpenAI Ads Manager, tied to a single ad account)Spend, clicks; conversion uploadChatGPT Ads

Payments ​

IntegrationConnection modeEvents capturedGuide
StripeRestricted API key (import of the last 90 days) + signed webhook destinations, secrets entered in ConfigurationSales (checkout), payments (recurring), refunds, subscriptionsStripe

E-commerce ​

IntegrationConnection modeEvents capturedGuide
ShopifyOAuth on your store (.myshopify.com subdomain); webhooks created automaticallySales (paid orders), refundsShopify

Communication ​

IntegrationConnection modeWhat it doesGuide
SlackOAuth on your workspaceAutomated reports, alerts and call analyses in your channelsSlack

Calls ​

IntegrationConnection modeEvents capturedGuide
AircallOne-click OAuth when available, otherwise API key; webhook URL to copy into Aircall (guide in the app)Completed calls, recordings, post-call notesAircall

Per-rep connections (Profile page) ​

These connections are not in the Integrations catalog: each rep makes them in their Profile.

IntegrationConnection modeWhat it doesGuide
Google CalendarOAuthTracking of the rep's meetings and recordingsGoogle Calendar / Outlook
Microsoft OutlookOAuthSame thing for Outlook usersGoogle Calendar / Outlook
ZoomOAuthCloud recordings, transcription and coachingZoom

Zoho CRM ​

Zoho CRM has no card in the catalog: sales (won or lost deals) arrive through a manual webhook to the Sale URL. See Zoho CRM.


How Data Gets Into DURUM.ai ​

1. Webhooks (real time) ​

A webhook is a notification sent by an external tool to DURUM.ai when an event occurs. It is the primary method for all CRM events: leads, applications, bookings, no-shows, sales, payments, refunds.

Depending on the tool, the webhook is created automatically at connection (GoHighLevel, Pipedrive, Typeform, ClickFunnels, Shopify), or you copy the URL shown in the app into the tool (Stripe, Zoho Books, iClosed, Aircall).

2. Periodic sync ​

Some data is read periodically through APIs:

DataFrequency
Meta Ads spendEvery hour (last 3 days), 30-day pass about once a day, daily reconciliation
Google Ads, TikTok Ads, ChatGPT Ads spendEvery hour
CalendlyEvery 15 minutes
Zoho BooksEvery 6 hours
GoHighLevelInitial import at connection, then users and calls every 10 minutes
StripeImport of the last 90 days when the key is connected

INFO

Periodic sync imports spend and enriches contacts. Your funnel events (leads, bookings, sales) arrive through webhooks, in real time.


Your Business ID ​

Every webhook URL carries your Business ID (bid=), which ties the event to your account. You find it in Settings → Integrations → For your developer section, where the URLs are already filled in.

WARNING

A webhook without a valid bid= cannot be tied to your account. Always copy the URLs from the app rather than rebuilding them by hand.


The Eight Standard Webhooks ​

They are listed in Settings → Integrations → For your developer, with a Copy button for each. Format:

https://app.durum.ai/api/webhook/{type}?bid={your_business_id}
Event typeURLMethodRecognized sources
Lead (new prospect)https://app.durum.ai/api/webhook/lead?bid=YOUR_BUSINESS_IDPOSTGHL, Typeform, iClosed, Pipedrive, ClickFunnels, generic
Applicationhttps://app.durum.ai/api/webhook/application?bid=YOUR_BUSINESS_IDPOSTGHL, generic
Booking (appointment booked)https://app.durum.ai/api/webhook/booking?bid=YOUR_BUSINESS_IDPOSTCalendly, GHL, iClosed, Pipedrive, generic
No-showhttps://app.durum.ai/api/webhook/no-show?bid=YOUR_BUSINESS_IDPOSTCalendly, GHL, iClosed
Sale (deal closed, checkout completed)https://app.durum.ai/api/webhook/sale?bid=YOUR_BUSINESS_IDPOSTZoho CRM, GHL, Stripe, iClosed, Pipedrive, ClickFunnels, generic
Payment (invoice paid)https://app.durum.ai/api/webhook/payment?bid=YOUR_BUSINESS_IDPOSTStripe, Zoho Books, iClosed, GHL, generic
Refundhttps://app.durum.ai/api/webhook/refund?bid=YOUR_BUSINESS_IDPOSTStripe
Add to carthttps://app.durum.ai/api/webhook/add-to-cart?bid=YOUR_BUSINESS_IDPOSTStore, funnel, checkout, generic, DURUM pixel (durum.track('AddToCart'))

TIP

For GHL through a manual workflow, add &source=ghl; for iClosed, &source=iclose; for Zoho Books, &source=zoho. The URLs shown in the app's guides already carry this parameter.

Have an event of your own (pipeline stage, custom field)? In Settings → Events and CAPI → Events, add a custom event: it gets its own webhook URL and can then be sent to your ad platforms from the Conversions tab. The expected data format is described in Sending Data (webhook).


UTM Tracking: Essential for Attribution ​

To link your leads and sales to the right ads, install the DURUM.ai tracking script on your opt-in pages and keep your UTM parameters in your ads. Without it, your data arrives but without ad attribution.

See the complete guide: UTM Tracking. If a webhook misbehaves: Webhook Troubleshooting.


Powered by DURUM.ai: ad attribution and operational intelligence