Skip to main content

​
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:
  1. Click the field
  2. Select a Quivly field from the dropdown, or click Create New Field to add a custom field
  3. 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

TypeUse for
StringText values
NumberNumeric values
BooleanTrue/false values
DateDates and timestamps
EmailEmail addresses
URLWeb links
JSONComplex nested data
ReferenceLinks 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