Convert inbound leads at scale
View Qualified's documentation.
Overview
Qualified is a conversational sales and marketing platform that helps revenue teams identify and engage with website visitors. With the Qualified destination, you can sync lead and company data from your data warehouse to Qualified, ensuring your sales team has the most up-to-date information when engaging with prospects.
Supported syncing
| Sync Type | Description | Supported Sync Modes | API Reference |
|---|---|---|---|
| Leads | Sync data from any source to leads in Qualified | Upsert | Qualified API docs |
| Companies | Sync data from any source to companies in Qualified | Upsert | Qualified API docs |
For more information about sync modes, refer to the sync modes docs.
Connect to Qualified
Go to the Destinations overview page and click the Add destination button. Select Qualified and click Continue.
You will be required to enter your Qualified API key. Generate a Qualified API key with access to the Enterprise bulk endpoints in your Qualified account. The API key must have permissions to access the bulk API endpoints for leads and companies.
The API key must have Enterprise bulk access to use the Qualified destination. Confirm that your API key has the necessary permissions before connecting.
Paste the API key exactly as provided; Hightouch passes it as a Bearer token in API requests.
Sync configuration
Once you've set up your Qualified destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the Qualified destination you want to sync to.
Object selection
Choose which Qualified object to sync to:
- Leads: Sync lead data to Qualified
- Companies: Sync company data to Qualified
Record matching
Records are matched from your model to Qualified based on the object type:
- Leads: Match by Email. The email address is the primary identifier for leads in Qualified. Qualified upserts leads by email address.
- Companies: Match by Domain. The company domain is the primary identifier for companies in Qualified. Qualified upserts companies by domain.
The record should be matched using a unique identifier. For leads, ensure the email column contains unique values. For companies, ensure the domain column contains unique values. Duplicate identifiers may cause sync errors or unexpected behavior.
Leads synced to Qualified will not appear in the Qualified interface until they have activity associated with them (such as website visits or engagement). The data is successfully synced, but Qualified requires activity before displaying leads in the platform.
Field mapping
You can sync columns from your source to Qualified's default and custom fields. Map Hightouch columns to Qualified fields in the field mapping section.
When syncing Leads, you can map both:
- Lead fields: Fields that belong to the lead record
- Company fields: Fields that belong to the associated company record
When syncing Companies, you can map:
- Company fields: Fields that belong to the company record
Qualified requires object fields to be created in advance. After adding new fields in Qualified, click "Refresh fields" in the mapper to pull the latest definitions. Hightouch cannot provision fields automatically.
Tips and troubleshooting
Sync performance
Qualified uses bulk API endpoints to efficiently sync large volumes of data. The destination automatically:
- Groups rows into bulk jobs (up to 500 rows per job)
- Manages job polling and status checks
- Handles rate limiting with automatic retries
- Processes job results and reports rejected rows
If you experience rate limiting, contact Qualified support to understand your account's rate limits.
Common errors
If you encounter an error or question not listed below and need assistance, don't hesitate to . We're here to help.
API key authentication errors
If you receive authentication errors, verify that:
- Your API key is correct and has not expired
- The API key has Enterprise bulk access permissions
- The API key has access to both lead and company endpoints
Rate limiting
If you encounter rate limit errors (429 or 503 status codes), the destination will automatically retry with exponential backoff. Contact Qualified support to understand your account's specific rate limits.
Field mapping errors
If you receive errors about invalid fields:
- Ensure custom fields exist in Qualified before mapping to them
- Verify field names match exactly (field names are case-sensitive)
- Check that the data types in your model match the expected types in Qualified
Live debugger
Hightouch provides complete visibility into the API calls made during each of your sync runs. We recommend reading our article on debugging tips and tricks to learn more.
Sync alerts
Hightouch can alert you of sync issues via Slack, PagerDuty, SMS, or email. For details, please visit our article on alerting.