create_form_submission
Create form submissions in CallRail to backfill offline leads from non-tracked channels, enabling proper attribution and lead-status workflow integration.
Instructions
Manually create a form submission (e.g. backfill an offline lead).
Useful when you receive a lead through a non-CallRail-tracked channel (paper form, in-person, etc.) and want it visible in CallRail with proper attribution + lead-status workflow.
Args:
company_id: 'COM...' id. Required.
referrer / referring_url / landing_page_url: All three required
(CallRail enforces "either session_id or all 3 of these").
Use the original web context if known, or "(direct)" /
"https://offline" placeholders for in-person leads.
form_url: URL of the form page if applicable.
form_data: Dict of form-field values (e.g.
{"name": "Kevin", "email": "k@x.com", "phone": "412-555-1234"}).
customer_phone_number / name / email: Set on the submission directly
(overrides form_data if both are set).
note, tags, value, lead_status: Standard lead-management fields.
account_id: Auto-resolves if omitted.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company_id | Yes | ||
| referrer | Yes | ||
| referring_url | Yes | ||
| landing_page_url | Yes | ||
| form_url | No | ||
| form_data | No | ||
| customer_phone_number | No | ||
| customer_name | No | ||
| customer_email | No | ||
| note | No | ||
| tags | No | ||
| value | No | ||
| lead_status | No | ||
| account_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |