Webhook Payload Format

This reference documents all supported fields in webhook payloads.

Required Fields

Field	Type	Description
`email`	string	Lead’s email address

Recommended Fields

Field	Type	Description
`lead_id`	string	Your system’s unique identifier
`first_name`	string	Lead’s first name
`last_name`	string	Lead’s last name
`company_name`	string	Lead’s company

Optional Fields

Field	Type	Description
`source`	string	Lead source (e.g., “hubspot”, “website”)
`job_title`	string	Lead’s job title
`phone`	string	Phone number
`industry`	string	Company industry
`company_size`	string	Company size range
`website`	string	Company website URL
`linkedin_url`	string	LinkedIn profile URL
`notes`	string	Additional notes
`tags`	string[]	Array of tags
`custom_fields`	object	Custom key-value pairs

Minimal Payload

The absolute minimum required:


{
  "email": "lead@example.com"
}

Recommended Payload

For best video personalization:


{
  "lead_id": "crm-12345",
  "email": "john.doe@acme.com",
  "first_name": "John",
  "last_name": "Doe",
  "company_name": "Acme Corporation",
  "source": "website-form"
}

Full Payload Example


{
  "lead_id": "crm-12345",
  "email": "john.doe@acme.com",
  "first_name": "John",
  "last_name": "Doe",
  "company_name": "Acme Corporation",
  "job_title": "VP of Marketing",
  "phone": "+1-555-0123",
  "source": "hubspot",
  "industry": "Technology",
  "company_size": "50-200",
  "website": "https://acme.com",
  "linkedin_url": "https://linkedin.com/in/johndoe",
  "notes": "Met at SaaS conference",
  "tags": ["enterprise", "hot-lead", "q4-target"],
  "custom_fields": {
    "product_interest": "Enterprise Plan",
    "budget_range": "$10k-50k",
    "timeline": "Q1 2025",
    "competitor_using": "Competitor X",
    "meeting_requested": true
  }
}

Custom Fields

Use custom_fields for any additional data:


{
  "custom_fields": {
    "deal_value": 50000,
    "sales_stage": "demo-scheduled",
    "referral_source": "partner-abc"
  }
}

Access in scripts:


{{custom_fields.deal_value}}
{{custom_fields.referral_source}}

Field Validation

Field	Validation
`email`	Must be valid email format
`phone`	E.164 format recommended
`website`	Must include protocol (https://)
`tags`	Max 20 tags, 50 chars each
`custom_fields`	Max 50 fields, 1000 chars each value

Timestamps

Include timestamps in ISO 8601 format:


{
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-01-15T14:45:00Z"
}

Next Steps

Security - Secure your webhooks
Campaign Rules - Match leads to campaigns