Lists & Segments

Organize your audience into targeted groups for precise campaign delivery.

Creating a List

1. Go to Lists in the dashboard sidebar
2. Click Create List
3. Enter a list name (e.g., "Newsletter Subscribers", "Product Updates")
4. Click Save

Your list is now ready to receive contacts.

Adding Contacts

Option 1: Import from CSV

1. Open your list and click Import Contacts
2. Upload your CSV file
3. Map columns to Transmit fields
4. Click Import

Option 2: Add Manually

1. Open your list and click Add Contact
2. Enter email and optional details
3. Click Save

Option 3: Via API

curl -X POST https://api.xmit.sh/contacts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"email": "user@example.com", "listId": "list_xxx"}'

CSV Format Reference

email,firstName,lastName,metadata
john@example.com,John,Doe,"{""source"": ""website""}"
jane@company.com,Jane,Smith,"{""plan"": ""pro""}"

• Mapping: You can map custom headers to Transmit fields during the import process.
• Deduplication: Existing contacts are automatically updated based on their email address.

Custom Metadata

Store arbitrary data with each contact using JSON metadata. This can be used for personalization or internal tracking.

// API example: Update contact with metadata
await transmit.contacts.update(id, {
  metadata: {
    lastPurchase: "2025-12-01",
    loyaltyTier: "Gold"
  }
});

Managing Contacts

From your list view, you can:

• Search contacts by email or name
• Edit contact details and metadata
• Remove contacts from the list
• Export your list to CSV

Next Steps

• Create a Campaign — Send to your list
• Set up Webhooks — Track engagement events