Skip to main content

​
Overview

Manage your subscriber list with Migma’s contact management system. Add subscribers individually or through bulk CSV import, organize with tags, and maintain a healthy list.

Add Subscribers

Single or bulk CSV import

Custom Fields

Flexible key-value data storage

Smart Tagging

Organize and segment with tags

​
Viewing Contacts

Navigate to /contacts in your project to view all subscribers in a sortable, filterable table. Table columns:
  • Email address (sortable)
  • Name (sortable)
  • Tags (colored badges, clickable to filter)
  • Status badge (subscribed, unsubscribed, non-subscribed, bounced)
  • Date added (sortable)
  • Actions menu (Edit, Send Email, Delete)
Quick actions:
  • Add Subscriber - Add single contact
  • Bulk Import - Upload CSV file
  • Search - Find by email or name
  • Filter - By status and tags
  • Sort - By email, name, or date

​
Search & Filter

Use the search box to find contacts by email or name: 
[email protected]    → Find exact email
@gmail.com          → All Gmail subscribers
John                → Names or emails containing "John"

​
Filter by Status

  • Subscribed
  • Unsubscribed
  • Non-subscribed
  • Bounced
Active subscribers - Can receive marketing emailsSet via: Signup forms, CSV import, manual add

​
Filter by Tags

  • Click tag badges to filter by that tag
  • Select multiple tags from dropdown (OR logic)
  • Clear individual tags or reset all filters

​
Adding Contacts

  • Add Single Contact
  • Bulk CSV Import
Manual add:
  1. Click “Add Subscriber”
  2. Enter email (required)
  3. Add name, tags, custom fields (optional)
  4. Set status (default: subscribed)
  5. Click “Add Contact”
Duplicate handling: If email exists, shows error with option to view existing contact

​
Editing Contacts

Click Edit from the actions menu to update contact information: Editable fields:
  • Email address
  • First and last name
  • Tags (add/remove)
  • Custom fields (add/edit/remove)
  • Subscription status
Viewing details: Click contact row to see full profile with creation date, update history, and all associated data

​
Custom Fields

Store additional data for each contact using key-value pairs. Common use cases:
  • Company name
  • Job title
  • Purchase history
  • User preferences
  • Account IDs
  • Custom attributes
Adding custom fields:
1

During Add/Edit

Click “Add Custom Field” when adding or editing a contact
2

Enter Key-Value

  • Key: company
  • Value: Acme Corp
3

Save

Custom fields are stored with the contact
Using in emails:
  • Reference in email templates with merge tags
  • Segment by custom field values
  • Personalize content based on data

​
Tags

Organize contacts with tags for segmentation and filtering. Tag features:
  • Multiple tags per contact
  • Color-coded badges
  • Click to filter
  • Reusable across contacts
Example tags:
  • VIP - High-value customers
  • Newsletter - Newsletter subscribers
  • Trial - Trial users
  • Q4-2024 - Campaign-specific
Managing tags:
  • Add during contact creation
  • Add/remove when editing
  • Filter by one or multiple tags
  • Tags auto-complete from existing tags

​
Sending Emails

Send Email Campaigns

Learn how to send emails to contacts and segments
 Quick send options:
  • Send to individual contact (Actions menu → Send Email)
  • Send to filtered/tagged group
  • Send to entire list

​
Preference Center

Preference Management

Set up preference center for subscriber self-management
 Generate preference URLs:
  • Actions menu → “Get Preference URL”
  • Unique URL per contact
  • Allows subscribers to update info and unsubscribe

​
Deleting Contacts

Delete individual contact:
  1. Click Actions menu → Delete
  2. Confirm deletion
  3. Contact permanently removed
Bulk delete:
  • Filter/search for contacts to delete
  • Select multiple (future feature)
  • Or delete individually
Permanent deletion - Cannot be undone. Consider tagging as inactive instead of deleting.

​
Duplicate Detection

Automatic duplicate prevention:
Email addresses are unique - cannot add duplicate emails
During CSV import, duplicates are automatically skipped
Existing contacts are not updated during import
When adding manually:
  • System checks if email exists
  • Shows error if duplicate found
  • Offers link to view existing contact
During CSV import:
  • Duplicate emails are counted and skipped
  • Import summary shows how many were skipped
  • Existing contact data is preserved

​
Exporting Contacts

Export via API: Export your contact list programmatically: 
GET /api/contacts/export
Returns CSV with all contact data including custom fields and tags.

API Documentation

Full API reference for contact management

​
Best Practices

  • Remove bounced emails promptly
  • Honor unsubscribes immediately
  • Archive inactive subscribers (6+ months no opens)
  • Never re-subscribe unsubscribed contacts
  • Create consistent tag naming convention
  • Tag by: interest, engagement, source, campaign
  • Remove outdated tags regularly
  • Use tags for segmentation
  • Store data you’ll use for personalization
  • Keep keys consistent (e.g., company, not Company Name or comp)
  • Don’t store sensitive data (passwords, payment info)
  • Use for segmentation and targeting
  • Review contact list monthly
  • Clean up bounced emails
  • Update tags and custom fields
  • Export backups regularly

​
Next Steps

CSV Upload

Bulk import contacts from CSV files

Send Emails

Send campaigns to your contacts

Preference Center

Set up subscriber self-management

Audience Overview

Back to audience management overview

​
Need Help?

Discord Community

Get help from community

Video Tutorials

Watch step-by-step guides

Support Team

Contact support

API Documentation

Integrate programmatically