Get team-wide engagement metrics

Request

Returns aggregated outreach metrics across the whole team for the requested period.

Important: despite accepting a filter field, this endpoint currently returns team-wide totals only — filter.sender_profile_uuid and other keys are silently ignored. The group_by field is also accepted but does not produce a per-group breakdown in the response. Plan for team-level reporting only.

For per-sender activity counts (without period filter), use: - POST /flows/api/linkedin-messages/group-counts with filter.sender_profile_uuid - GET /flows/api/tasks?filter[sender_profile_uuid][]=<uuid>&filter[status][]=<status>

Security

bearerAuth

Bodyapplication/jsonrequired

period_fromstring, (date-time)required

ISO 8601 datetime for the start of the period (inclusive).

Example:"2026-04-01T00:00:00Z"

period_tostring, (date-time)required

ISO 8601 datetime for the end of the period (inclusive).

Example:"2026-04-28T23:59:59Z"

flowsArray of strings, (uuid)

Optional list of flow UUIDs to scope the metrics. Empty array = all flows.

Default:[]

metricsArray of stringsrequired

List of metric names to retrieve. See the enum below.

Items Enum:"linkedin_connection_request_sent_count""linkedin_connection_request_accepted_count""linkedin_sent_count""linkedin_opened_count""linkedin_inbox_count""linkedin_inmail_sent_count""linkedin_inmail_replied_count""email_sent_count""email_opened_count""email_clicked_count"

Example:

[
  "linkedin_sent_count",
  "linkedin_inbox_count",
  "email_sent_count"
]

filterobject

Currently ignored — included for forward compatibility once the backend filter is fixed. See the description above.

group_bystring

Group key. Accepted values do not currently affect the response shape on the public endpoint.

Enum:"sender_profiles""flows""lists""tags""pipeline_stages""workflows""date"

Example:"sender_profiles"

POST

/leads/api/leads/metrics

curl -i -X POST \
  https://leadgen.grinfi.io/leads/api/leads/metrics \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "period_from": "2026-04-01T00:00:00Z",
    "period_to": "2026-04-28T23:59:59Z",
    "flows": [],
    "metrics": [
      "linkedin_connection_request_sent_count",
      "linkedin_connection_request_accepted_count",
      "linkedin_sent_count",
      "linkedin_opened_count",
      "linkedin_inbox_count"
    ],
    "filter": {},
    "group_by": "sender_profiles"
  }'

Responses

Aggregated metrics for the period.

Bodyapplication/json

totalobject

Map of metric name → count. Only the metrics requested in the input are present in the response.

Example:

{
  "linkedin_connection_request_sent_count": 7694,
  "linkedin_connection_request_accepted_count": 3530,
  "linkedin_sent_count": 5250,
  "linkedin_opened_count": 2265,
  "linkedin_inbox_count": 1202
}

Response

{
  "total": {
    "linkedin_connection_request_sent_count": 7694,
    "linkedin_connection_request_accepted_count": 3530,
    "linkedin_sent_count": 5250,
    "linkedin_opened_count": 2265,
    "linkedin_inbox_count": 1202
  }
}