Skip to main content
POST
/
v1
/
projects
/
{projectId}
/
attribution
curl --request POST \
  --url https://api.finseo.ai/v1/projects/PROJECT_ID/attribution \
  --header 'Authorization: Bearer sk_live_xxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "channelId": "ai_search",
    "respondentEmail": "jane@company.com",
    "respondentName": "Jane Smith",
    "dealValue": 12000,
    "dealCurrency": "EUR",
    "formId": "signup_form_v2",
    "pageUrl": "https://example.com/signup"
  }'

{
  "data": {
    "id": "a1b2c3d4-...",
    "channel_id": "ai_search",
    "channel_label": "AI Search (ChatGPT, Perplexity, etc.)",
    "channel_category": "ai_search",
    "respondent_email": "jane@company.com",
    "deal_value": 12000,
    "source": "api",
    "created_at": "2026-03-15T10:30:00Z"
  }
}
Record a self-reported attribution response. Use this to track how customers discovered your brand — from AI search, organic, social, ads, referrals, or any custom channel. Requires write scope on your API key.
​
projectId
string
required
The project ID.
​
channelId
string
required
Attribution channel identifier. Use standard IDs like ai_search, ai_chatgpt, ai_perplexity, google_search, social_media, paid_ads, referral, content, or any custom string.
​
respondentEmail
string
Lead email address.
​
respondentName
string
Lead full name.
​
respondentExternalId
string
External ID from your CRM or system.
​
dealValue
number
Revenue amount attributed to this lead.
​
dealCurrency
string
default:"USD"
ISO currency code.
​
formId
string
Identifier of the source form (e.g. Typeform form_id, HubSpot form ID).
​
pageUrl
string
Page URL where the form was submitted.
​
metadata
object
Additional custom data as key-value pairs.
curl --request POST \
  --url https://api.finseo.ai/v1/projects/PROJECT_ID/attribution \
  --header 'Authorization: Bearer sk_live_xxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "channelId": "ai_search",
    "respondentEmail": "jane@company.com",
    "respondentName": "Jane Smith",
    "dealValue": 12000,
    "dealCurrency": "EUR",
    "formId": "signup_form_v2",
    "pageUrl": "https://example.com/signup"
  }'

{
  "data": {
    "id": "a1b2c3d4-...",
    "channel_id": "ai_search",
    "channel_label": "AI Search (ChatGPT, Perplexity, etc.)",
    "channel_category": "ai_search",
    "respondent_email": "jane@company.com",
    "deal_value": 12000,
    "source": "api",
    "created_at": "2026-03-15T10:30:00Z"
  }
}