Agent & Attribution
Custom Webhook

Custom Webhook

Send attribution data from any source to Finseo via the universal webhook endpoint. Works with any payload format.

Overview

What you getwith the Custom Webhook integration

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.

Use cases

What you can dowith Custom Webhook and Finseo

01

Custom CRM integration

For homegrown or niche CRMs without native webhook support, build a custom integration that POSTs lead and deal data to the Finseo webhook endpoint.

02

Internal application tracking

For internal apps that capture user signups, demos, or qualifications, POST events to Finseo for centralized AI search attribution reporting.

03

Backend trigger

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.

04

Multi-source consolidation

Consolidate attribution data from multiple sources (form, CRM, payment) into one webhook with enriched metadata before sending to Finseo.

05

Migration from other tools

Backfill historical attribution data from spreadsheets, databases, or legacy systems by POSTing to the Finseo webhook in a script.

Why it matters

Why Custom Webhook customersneed AI visibility tracking

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.

Comparison

Custom Webhook alonevs Custom Webhook with Finseo

How using Custom Webhook on its own compares to pairing it with Finseo for AI visibility and attribution.

Setup

Custom Webhook alone

N/A

With Finseo

POST JSON to URL

Format flexibility

Custom Webhook alone

Fixed schema

With Finseo

Auto detect or explicit

Security

Custom Webhook alone

Basic

With Finseo

HMAC SHA256 signing optional

Custom field support

Custom Webhook alone

No

With Finseo

Field mapping via Finseo settings

Use cases

Custom Webhook alone

Limited

With Finseo

Anything that can POST JSON

How to connect

Connect Custom Webhook to Finseoin 5 steps, no code required

Step 01

Get your Finseo webhook URL

In Finseo, click Connect on the Custom Webhook integration card to reveal your project specific webhook URL.

Step 02

Decide on payload format

For explicit control, use { channelId: "ai_chatgpt", respondentEmail: "...", dealValue: 1000 }. For auto detection, send any JSON with a field containing attribution keywords.

Step 03

POST to the URL

From your application, script, or third party tool, POST a JSON payload to the webhook URL. Add HTTP header Content-Type: application/json.

Step 04

Optional: add HMAC signature

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.

Step 05

Verify in dashboard

Submit a test payload. Check the Finseo Attribution dashboard within 10 seconds. Check the Finseo logs (Settings, then Logs) if data does not appear.

FAQ

Custom Webhook and AI search visibilityquestions people ask before choosing a tool

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.

Mit uns sprechen

Connect Custom Webhook and dominate AI search

Join hundreds of brands using Finseo to track and improve their visibility in ChatGPT, Perplexity, Claude, Gemini, and Google AI Overviews.