List Push Behavior
How list triggers route contacts into connected integrations.
When you push a LeadTale list to a connected integration, contacts are mapped to that integration's native field names and POSTed via the integration's API or webhook.
The flow
- You add contacts to a list (manually, via Smart List automation, or via API).
- You configure a List Push action on the list, choosing a connected integration and field mapping.
- When the trigger fires (manual, schedule, or rule), LeadTale iterates contacts in the list, applies the field mapping, and pushes each contact via the integration's transport.
- Push results (success / error / skipped) are recorded on the list and visible in the UI.
Field mapping by integration
Each integration adapter has its own native field schema. Mapping happens once at integration setup; you can edit it later.
| Integration | Required field | Common optional fields |
|---|---|---|
| GoHighLevel (GHL) | email | firstName, lastName, phone, companyName, website, address1, city, state, country, postalCode |
| HubSpot | email | firstname, lastname, phone, jobtitle, company, website, address, city, state, country, industry, lifecyclestage |
| Hunter | email | first_name, last_name, company, position, twitter, linkedin_url, phone_number, company_size, website, country_code, notes |
| HeyReach | linkedinUrl | email, firstName, lastName, companyName, companyUrl, position, location, phoneNumber, customVariables |
| Insightly | EMAIL_ADDRESS | PHONE, PHONE_MOBILE, WEBSITE, LINKEDIN_URL, FIRST_NAME, LAST_NAME, TITLE, ORGANISATION_NAME |
| Outplay | email | firstName, lastName, title, company, phone, linkedin, twitter, city, state, country, tags |
| MeetAlfred | linkedin_url | email, name, headline, location, picture |
| Webhook (custom) | user-defined | user-defined |
| Zapier | user-defined | user-defined |
Field names match the downstream API's native schema — LeadTale does not transform names. What you see in your CRM is exactly what LeadTale sent.
Error handling
If a push fails for a contact (downstream 4xx), LeadTale records the error and continues with the next contact. Failed contacts appear in the list's "Push Errors" tab.
LeadTale does not retry failed pushes automatically — you can manually re-push from the list view.