Kustomer
Sync data from your warehouse to Kustomer. Keep your Kustomer Customers and Companies enriched with the latest customer data from your data warehouse.
Prerequisites
- A Kustomer account with API access enabled
- A Kustomer API key with read/write permissions for customers and companies
- Admin access to generate API keys in Kustomer Settings
Authentication
API Key
- In Kustomer, go to Settings > Security > API Keys
- Click Add API Key
- Give the key a descriptive name (e.g., “Zeotap Integration”)
- Select the required permissions:
org.user.customer.read,org.user.customer.write,org.user.company.read,org.user.company.write - Copy the generated API key
- In Zeotap, paste the API key into the API Key field
Configuration
Kustomer does not require additional configuration fields beyond authentication — the API uses a fixed base URL (api.kustomerapp.com).
Target Settings
| Field | Type | Required | Description |
|---|---|---|---|
| Object Type | Select | Yes | The Kustomer object to sync to: Customers or Companies |
| Tag Name | Text | No | Tag to manage for audience sync modes. Required for audience syncs. |
Supported Operations
Sync Modes
| Mode | Supported |
|---|---|
| Upsert | Yes |
| Insert | Yes |
| Update | Yes |
| Mirror | — |
Audience Sync Modes
| Mode | Supported |
|---|---|
| Add | Yes |
| Remove | Yes |
| Mirror | Yes |
| Upsert | — |
Features
- Field Mapping: Yes
- Schema Introspection: No — use the default destination fields or type field names manually
Required Mapping Fields
| Object | Required Fields |
|---|---|
| Customers | |
| Companies | name |
Default Destination Fields
Customers
| Field | Type |
|---|---|
name | string |
email | string |
phone | string |
externalId | string |
username | string |
locale | string |
avatarUrl | string |
Companies
| Field | Type |
|---|---|
name | string |
externalId | string |
Troubleshooting
Authentication failed
Ensure your API key is correct and has not been revoked. API keys can be regenerated in Settings > Security > API Keys in Kustomer.
Permission denied
Verify the API key has the required permissions for the object type you are syncing to. Customer syncs require org.user.customer.write and company syncs require org.user.company.write.
Rate limiting
Kustomer enforces API rate limits. Zeotap handles rate limiting with automatic backoff and retries. If you encounter persistent rate limiting, consider reducing sync frequency or batch sizes.
Tag not applied
For audience sync modes, ensure the Tag Name field is configured in the destination target settings. Without a tag name, audience syncs will fail.