Learn how to map fields from your webhook payload to the correct Invelo fields.
When setting up a webhook integration, you’ll need to map the fields from your webhook payload to Invelo’s record fields. This ensures that the data sent from your form or external app correctly populates your Property and Contact records in Invelo.
Step 1: Understand Field Mapping
Field mapping lets you define how data from your webhook payload is matched to Invelo fields.
Use dot notation to access nested data within your payload. For example:
-
property.address_1 -
contact.first_name
This tells Invelo exactly where to find the information in your incoming webhook request.
Step 2: Match Form Fields to Invelo Lead Fields
Make sure the field names your form or application sends match Invelo’s field structure. Use lowercase and underscores for smoother data transfer.
| Your Form Field | Invelo Field |
|---|---|
| first_name | first_name |
| last_name | last_name |
| phone | phone |
| property_address | property_address |
You can find more examples and webhook setup details here:
🔗 Invelo Webhooks Integration Guide
Step 3: Required Fields for Successful Record Creation
When mapping your webhook, ensure that all required fields are included. Missing any of these will cause your record creation to fail.
Property Record Required Fields
-
APN
-
Property Address Street
-
Property Address City
-
Property Address State
-
Property Address Zip
-
Lifecycle Stage
Contact Record Required Fields
-
First Name
-
Last Name
-
Company Name
-
Phone Number
-
Email Address
-
Mailing Address Street
-
Mailing Address City
-
Mailing Address State
-
Mailing Address Zip
Best Practices for Field Mapping
- Use consistent lowercase field names with underscores (
first_name, notFirstName). - Double-check that your payload matches Invelo’s required structure before testing.
- Use dot notation for nested data to ensure accuracy.
- Test your webhook with sample data before activating it.
By correctly mapping your webhook fields, Invelo can automatically capture and organize your leads, properties, and contact details — keeping your CRM clean, accurate, and up-to-date.