Create 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"
  }
}

POST

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.

string

required

The project ID.

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.

string

Lead email address.

string

Lead full name.

string

External ID from your CRM or system.

number

Revenue amount attributed to this lead.

string

default:"USD"

ISO currency code.

string

Identifier of the source form (e.g. Typeform form_id, HubSpot form ID).

string

Page URL where the form was submitted.

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"
  }
}

Projects

Prompts

Metrics

Competitors

Sources

Tags

Fan-outs

Tasks

Export

Attribution

Create Attribution