Overview
Field mapping connects data from your integrated systems (Salesforce, HubSpot, Stripe, etc.) to Quivly objects. Map external fields to core Quivly fields or create custom fields during the process.Prerequisites
- Integration is connected and has synced data
- You have Admin access
Configuring Field Mappings
1
Navigate to Object Settings
Go to Settings → Objects → Select the object you want to configure (e.g., Customers)
2
Select Integration
In the Configuration tab, select which integration to map from the dropdown.
Once you save a mapping, the integration is locked and can only be changed by support.
3
View Available Fields
The left panel shows all fields available from the external system. Use the search box to filter fields. Hover over fields to see sample values.
4
Map Fields
For each external field you want to sync:
- Click the field
- Select a Quivly field from the dropdown, or click Create New Field to add a custom field
- The mapping is saved automatically
5
Create Custom Fields (Optional)
When creating a new field:
- Enter a field label
- Select the field type (string, number, boolean, date, email, url, json, or reference)
- For reference fields, select which object it links to
6
Save Configuration
Click Save to activate your mappings. Changes apply on the next sync.
Field Types
| Type | Use for |
|---|---|
| String | Text values |
| Number | Numeric values |
| Boolean | True/false values |
| Date | Dates and timestamps |
| Email addresses | |
| URL | Web links |
| JSON | Complex nested data |
| Reference | Links to other Quivly objects |
Auto-Computed Fields
Some fields are automatically computed by Quivly and cannot be manually mapped. These appear in a separate “Auto-computed Fields” section with a lock icon.Notes
- Each external field can only be mapped to one Quivly field
- Core field mappings are locked after first save
- Use the Raw Data Preview section to see sample data from the external system