The Unisender connector synchronizes email contacts and list metadata from Unisender into your knowledge base. Each contact is converted to a document containing email, name, custom fields, and subscription status.
Authentication
API Key — requires:
- Valid Unisender API key with access to contacts and lists
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| List ID | Input | Yes | The Unisender list ID to sync contacts from |
| Include Custom Fields | Switch | No | Include custom field values in documents |
| Max Contacts | Input | No | Limit the number of synced contacts (default: unlimited) |
| Status Filter | Dropdown | No | Filter by subscription status (active/inactive/all) |
How It Works
- List Retrieval — Fetches the selected list and its custom fields metadata
- Contact Listing — Retrieves contacts with pagination (100 per page)
- Document Generation — Each contact rendered as
email: name (custom_fields) - Field Normalization — Custom fields are prefixed and normalized
Document Format
Email: user@example.com
Name: John Doe
Status: Active
Custom Field 1: ValueMetadata Tags
| Tag | Type | Description |
|---|---|---|
| List ID | Text | Source list identifier |
| Subscription Status | Category | active, inactive, or unconfirmed |
Pagination
Uses offset-based pagination. Cursor format: offset:{contact_offset}.
Limitations
- Maximum 100 contacts per API page
- Custom fields must be configured in Unisender beforehand
- Inactive contacts can be filtered but not deleted