Create lead
whatconverts_create_leadWRITE: add a lead to WhatConverts, for example an offline phone call, a form submission from another system or a sale you want attributed. It appears in reports and counts toward lead totals; send_notification is always off, so no emails go out. Not idempotent: calling twice creates two leads. A Profile key adds to its own profile; an Agency key must pass profile_id. POST /leads.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | No | Message body (text_message only). | |
| lead_url | No | URL where the lead occurred. | |
| quotable | No | ||
| form_name | No | Form name (web_form only). | |
| lead_type | Yes | Lead type. | |
| profile_id | No | Profile to add the lead to (required with an Agency key, not with a Profile key). | |
| landing_url | No | URL where the visitor arrived. | |
| lead_medium | No | Traffic medium, e.g. cpc. | |
| lead_source | No | Traffic source, e.g. google. | |
| quote_value | No | ||
| sales_value | No | ||
| date_created | No | When the lead happened (UTC); default now. | |
| lead_content | No | ||
| lead_keyword | No | ||
| phone_number | No | Contact phone, E.164. | |
| answer_status | No | phone_call only. | |
| caller_number | No | Caller number, E.164 (phone_call / text_message). | |
| custom_fields | No | ||
| email_address | No | Contact email address (stored on the lead; nothing is sent to it). | |
| lead_campaign | No | ||
| tracking_number | No | Tracking number, E.164 (phone_call / text_message). | |
| additional_fields | No | ||
| destination_number | No | Destination number, E.164 (phone_call). | |
| call_duration_seconds | No | Call length in seconds (phone_call only). |