API Reference

List scheduled and executed account activity

Returns a side-effect-free operational log of scheduled and executed outreach actions. The default window covers seven days before and seven days after the request time; explicit `from` and `to` values may cover at most 14 days. Future entries have `provisional: true` and may move when workflow branches, replies, fatigue, business hours, or account limits change. Use `executedAt` with a final `state` to distinguish completed delivery from planning. Results use cursor pagination. Unknown query parameters are rejected with `422 VALIDATION_ERROR`.

GET/v1/accounts/{accountGroupId}/activity

Integration notes

Required API permission

activity:read.

Prerequisites

integration_api_key, account_group_access.

Parameters

accountGroupIdPath

Type: string

Account group ID that scopes the request.

Required

fromQuery

Type: string

Inclusive ISO 8601 window start. Pair with to for reproducible audits.

Optional

toQuery

Type: string

Exclusive ISO 8601 window end. The effective window may not exceed 14 days.

Optional

campaignIdQuery

Type: string

Limit activity to one campaign.

Optional

leadIdQuery

Type: string

Limit activity to one prospect lead.

Optional

typeQuery

Type: string

Limit activity to one normalized action type.

Optional

stateQuery

Type: string

Limit activity to one normalized lifecycle state.

Optional

cursorQuery

Type: string

Opaque cursor returned as nextCursor.

Optional

limitQuery

Type: integer

Page size from 1 to 100.

Optional

Request body

This endpoint does not define a request body.

Responses

200

Account activity

Schema: ActivityListSuccessResponse

401

Invalid or missing API key

Schema: ErrorResponse

403

Missing required permission

Schema: ErrorResponse

422

Request validation failed

Schema: ValidationErrorResponse

429

Rate limit exceeded

Schema: ErrorResponse

500

Internal server error

Schema: ErrorResponse

502

Upstream service error

Schema: ErrorResponse

Response examples

200 Example JSONActivityListSuccessResponse

{
    "success": true,
    "data": {
        "items": [
            {
                "id": "507f1f77bcf86cd799439011",
                "displayAt": "2026-04-28T15:30:00.000Z",
                "scheduledAt": "2026-04-28T15:30:00.000Z",
                "executedAt": "2026-04-28T15:30:00.000Z",
                "originalScheduledAt": "2026-04-28T15:30:00.000Z",
                "nextScheduledAt": "2026-04-28T15:30:00.000Z",
                "type": "invitation",
                "state": "queued",
                "deliveryState": "queued",
                "campaignId": "507f1f77bcf86cd799439011",
                "campaignName": "Avery Stone",
                "workflowInstanceId": "507f1f77bcf86cd799439011",
                "leadId": "507f1f77bcf86cd799439011",
                "conversationId": "507f1f77bcf86cd799439011",
                "prospectName": "Avery Stone",
                "nodeId": "507f1f77bcf86cd799439011",
                "nodeSubType": "string",
                "workflowStepLabel": "string",
                "subject": "Quick follow-up",
                "content": "string",
                "reasonCode": "CONTENT_DISCARDED",
                "reason": "string",
                "provisional": true
            }
        ],
        "nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI2LTA0LTI4VDE1OjMwOjAwLjAwMFoifQ",
        "hasMore": true,
        "window": {
            "from": "2026-04-28T15:30:00.000Z",
            "to": "2026-04-28T15:30:00.000Z",
            "generatedAt": "2026-04-28T15:30:00.000Z"
        }
    },
    "error": null,
    "traceId": "507f1f77bcf86cd799439011"
}

401 Example JSONErrorResponse

{
    "success": false,
    "data": null,
    "error": {
        "code": "string",
        "message": "Thanks for the context. I can send over details this afternoon.",
        "details": "string"
    },
    "traceId": "507f1f77bcf86cd799439011"
}

403 Example JSONErrorResponse

{
    "success": false,
    "data": null,
    "error": {
        "code": "string",
        "message": "Thanks for the context. I can send over details this afternoon.",
        "details": "string"
    },
    "traceId": "507f1f77bcf86cd799439011"
}

422 Example JSONValidationErrorResponse

{
    "success": false,
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "message": "Thanks for the context. I can send over details this afternoon.",
        "details": "string"
    },
    "traceId": "507f1f77bcf86cd799439011"
}

429 Example JSONErrorResponse

{
    "success": false,
    "data": null,
    "error": {
        "code": "string",
        "message": "Thanks for the context. I can send over details this afternoon.",
        "details": "string"
    },
    "traceId": "507f1f77bcf86cd799439011"
}

500 Example JSONErrorResponse

{
    "success": false,
    "data": null,
    "error": {
        "code": "string",
        "message": "Thanks for the context. I can send over details this afternoon.",
        "details": "string"
    },
    "traceId": "507f1f77bcf86cd799439011"
}

502 Example JSONErrorResponse

{
    "success": false,
    "data": null,
    "error": {
        "code": "string",
        "message": "Thanks for the context. I can send over details this afternoon.",
        "details": "string"
    },
    "traceId": "507f1f77bcf86cd799439011"
}