Skip to content

Segments

Dynamic and static audience segmentation for targeted campaigns.

Features:

  • Dynamic segments with auto-updating filters
  • Static segments with manual membership
  • Filter by engagement, status, source, tags
  • Preview segment size before saving
  • Refresh dynamic segments on-demand

Filter Options:

  • Status (subscribed, pending_confirmation, unsubscribed, bounced, complained)
  • Source (api, import, form, manual)
  • Engagement metrics (opens, clicks, sent count)
  • Tags (AND/OR logic)
  • Custom field values

Example Segments:

  • Highly engaged subscribers (>10 opens)
  • Recent form signups (source=form, created <30 days)
  • At-risk contacts (sent >5, opened 0)
  • VIP customers (tags contain "premium")
Operations

List segments

Request

Retrieve all segments (both static and dynamic) for your account.

Response includes:

  • Segment name, description, type (static/dynamic)
  • Filter conditions for dynamic segments
  • Contact count (actual membership count)
  • Created/updated timestamps
Security
ApiKeyAuth
curl -i -X GET \
  https://api.mailerlogic.net/api/v1/contacts/segments \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Segments retrieved successfully

Bodyapplication/json
successboolean
Example:true
dataArray of objects
Response
{
  "success": true,
  "data": [
    { … }
  ]
}