Outreach Metrics

Outreach Metrics in Luella represent measurable engagement from real outreach emails sent to leads. These metrics capture activity over a selected time window, tracking how contacts interacted with your emails and whether any delivery issues occurred.

Metrics are scoped to a date range (fromMetricDate and toMetricDate, formatted as YYYY-MM-DD), and can be filtered by:

one or more mailboxIds
one or more clusterIds
one or more profileIds
one or more campaignIds
one or more sequenceIds

The outreach metric model

This model includes the metric name, value, and the date the metric was recorded. The available metrics reflect real campaign outcomes.

Properties

Name
metricName
Type
string
Description
One of:
- aggregate:contacted:count — Number of unique contacts contacted
- aggregate:opened:count — Number of tracked opens
- aggregate:clicked:count — Number of tracked link clicks
- aggregate:replies:count — Number of replies received
- aggregate:positive:count — Number of positive replies
- aggregate:bounces:count — Number of emails that bounced
Name
metricValue
Type
number
Description
The metric value for that day.
Name
metricDate
Type
string (YYYY-MM-DD)
Description
The date the metric was measured.

POST/outreach-metrics/ListOutreachMetrics

List outreach metrics

Retrieve outreach metrics over a date range, optionally filtered by mailbox, cluster, profile, campaign, or sequence.

Required attributes

Name
userId
Type
string
Description
ID of the user requesting the metrics.
Name
workspaceId
Type
string
Description
Workspace that owns the sending mailboxes.
Name
metricName
Type
string
Description
Metric to retrieve. See model above for valid values.
Name
fromMetricDate
Type
string (YYYY-MM-DD)
Description
Start of the range to query.
Name
toMetricDate
Type
string (YYYY-MM-DD)
Description
End of the range to query.

Optional attributes

Name
mailboxIds
Type
string[]
Description
Array of mailbox IDs to filter metrics for.
Name
clusterIds
Type
string[]
Description
Array of cluster IDs to filter.
Name
profileIds
Type
string[]
Description
Array of profile IDs to filter.
Name
campaignIds
Type
string[]
Description
Filter by campaign IDs.
Name
sequenceIds
Type
string[]
Description
Filter by sequence IDs.
Name
nextToken
Type
string
Description
Token for pagination.
Name
maxItems
Type
number
Description
Max results per page.

Request

POST

/outreach-metrics/ListOutreachMetrics

{
  "userId": "user_123",
  "workspaceId": "workspace_456",
  "metricName": "aggregate:contacted:count",
  "fromMetricDate": "2024-03-01",
  "toMetricDate": "2024-03-07",
  "campaignIds": ["camp_001"]
}

Response

{
  "items": [
    {
      "metricName": "aggregate:contacted:count",
      "metricValue": 87,
      "metricDate": "2024-03-01"
    },
    {
      "metricName": "aggregate:contacted:count",
      "metricValue": 92,
      "metricDate": "2024-03-02"
    }
  ],
  "nextToken": null
}