Get your Finseo webhook URL
In Finseo, click Connect on the Custom Webhook integration card to reveal your project specific webhook URL.
Send attribution data from any source to Finseo via the universal webhook endpoint. Works with any payload format.
For tools without a native Finseo integration, use the universal webhook endpoint. POST any JSON payload to your project specific URL. Finseo auto detects known formats (HubSpot, Salesforce, Typeform, Jotform, Pipedrive, Attio) or accepts raw JSON with explicit fields. The most flexible attribution input mechanism in Finseo.
For homegrown or niche CRMs without native webhook support, build a custom integration that POSTs lead and deal data to the Finseo webhook endpoint.
For internal apps that capture user signups, demos, or qualifications, POST events to Finseo for centralized AI search attribution reporting.
Trigger attribution events from your backend (e.g. on stripe charge succeeded, on user upgrade) by POSTing to the Finseo webhook with the AI source from cookies or session data.
Consolidate attribution data from multiple sources (form, CRM, payment) into one webhook with enriched metadata before sending to Finseo.
Backfill historical attribution data from spreadsheets, databases, or legacy systems by POSTing to the Finseo webhook in a script.
Every team has at least one tool without a native Finseo integration. The custom webhook is the escape hatch that ensures Finseo can ingest attribution data from anything. POST raw JSON, structured payloads, or known formats. Finseo handles the parsing. This makes Finseo the centralized attribution layer for your full stack, not just the integrations we have built natively.
How using Custom Webhook on its own compares to pairing it with Finseo for AI visibility and attribution.
| Feature | Custom Webhook alone | Custom Webhook + Finseo |
|---|---|---|
| Setup | N/A | POST JSON to URL |
| Format flexibility | Fixed schema | Auto detect or explicit |
| Security | Basic | HMAC SHA256 signing optional |
| Custom field support | No | Field mapping via Finseo settings |
| Use cases | Limited | Anything that can POST JSON |
Setup
N/A
POST JSON to URL
Format flexibility
Fixed schema
Auto detect or explicit
Security
Basic
HMAC SHA256 signing optional
Custom field support
No
Field mapping via Finseo settings
Use cases
Limited
Anything that can POST JSON
In Finseo, click Connect on the Custom Webhook integration card to reveal your project specific webhook URL.
For explicit control, use { channelId: "ai_chatgpt", respondentEmail: "...", dealValue: 1000 }. For auto detection, send any JSON with a field containing attribution keywords.
From your application, script, or third party tool, POST a JSON payload to the webhook URL. Add HTTP header Content-Type: application/json.
For security, configure an HMAC SHA256 signing key in Finseo Attribution settings. Sign the payload and include the signature in the X-Finseo-Signature header. Finseo verifies the signature before processing.
Submit a test payload. Check the Finseo Attribution dashboard within 10 seconds. Check the Finseo logs (Settings, then Logs) if data does not appear.
Finseo offers a native Custom Webhook integration: a universal JSON endpoint per project that accepts attribution data from any tool that can POST. Finseo attributes each event to ChatGPT, Perplexity, Claude, Gemini, or Microsoft Copilot and reports it beside tracked prompts. Use it when no native Answer Engine Optimization (AEO) integration exists for your source.
POST a JSON payload such as { "channelId": "ai_chatgpt", "respondentEmail": "...", "dealValue": 1000 } to your Finseo custom webhook URL with the header Content-Type: application/json. Supported channel IDs include ai_chatgpt, ai_perplexity, ai_claude, ai_gemini, and ai_copilot. Finseo records the event under ChatGPT or the matching engine and shows it in the Attribution dashboard within 10 seconds.
Yes. Finseo is a Generative Engine Optimization (GEO) platform whose custom webhook ingests attribution from homegrown CRMs, internal apps, backend triggers, or scripts. It differs from a generic webhook relay: Finseo parses known formats, categorizes each event as ChatGPT, Perplexity, or Claude, and links revenue back to the AI prompts and citations it tracks.
Click Connect on the Custom Webhook card in Finseo to reveal your project specific URL. From your app, script, or tool, POST JSON to that URL with the header Content-Type: application/json. Either include an explicit channelId or send any JSON with an attribution field for auto detection. No API key is needed; a test payload appears within 10 seconds.
The webhook accepts channelId plus optional respondentEmail, respondentName, dealValue, dealCurrency, formId, pageUrl, and metadata, or raw payloads from HubSpot, Salesforce, Typeform, Jotform, Pipedrive, Attio, Calendly, and Intercom. Data flows one way into Finseo. For security, configure an HMAC SHA256 key; Finseo verifies the X-Finseo-Signature header and rejects tampered requests with HTTP 401.
Yes. The custom webhook is included in every Finseo plan with no per-integration fee and no third party tool required, since anything that can POST JSON can use it. Rate limits are 100 requests per second per project with burst capacity to 500 per second, which covers most teams; contact Finseo for higher volumes.
Yes. Teams migrating from spreadsheets, databases, or legacy systems can POST historical events to the Finseo custom webhook from a script, adding a custom timestamp field in ISO 8601 format. Finseo accepts events up to 90 days old by default; for older backfills, contact Finseo. Backend triggers such as a Stripe charge succeeded event work the same way.
A webhook only moves data; it cannot tell whether a lead came from ChatGPT, Perplexity, or Google, and it knows nothing about which AI answers mention your brand. Finseo adds both layers: it categorizes each webhook event per AI engine and connects it to prompt tracking, so Answer Engine Optimization (AEO) decisions rest on revenue, not guesses.
Finseo returns HTTP 200 on success. On a 4xx or 5xx failure, implement retry logic in your sender, ideally with exponential backoff. Common causes are invalid JSON, a missing channelId, or the rate limit of 100 requests per second per project being exceeded. Check the Finseo logs under Settings, then Logs, for details on rejected webhook requests.

Use Zapier or Make to send attribution data from any form, CRM, or tool to Finseo. The universal connector for AI source tracking.
View integration
Use n8n to build custom attribution workflows. Open source, self hostable, and works with any data source via HTTP request nodes.
View integration
Connect Jotform to capture survey and form responses. Auto-attribute leads to ChatGPT, Perplexity, Claude, and other AI engines.
View integrationJoin hundreds of brands using Finseo to track and improve their visibility in ChatGPT, Perplexity, Claude, Gemini, and Google AI Overviews.