MYmyclickfunnels
Emails::Broadcasts::SendAction

List Send Actions

Changed on

List all send actions for an email broadcast. Send actions represent past or scheduled delivery attempts for the broadcast.

get/emails/broadcasts/{broadcast_id}/send_actions

Request

Path parameters

broadcast_idstring required

Query parameters

afterstring

ID of item after which the collection should be returned. More examples and info about pagination in our guides.

per_pageinteger

Records per page. Defaults to 20; raise it up to 100 for bulk reads. A larger value returns 100 records. Zero, a negative or a non-integer value is a 422. The Link next-page URL keeps the value, so a client following it keeps the page size. More in our guides.

sort_order'asc' | 'desc'

Sort order of a list response. Use 'desc' to reverse the default 'asc' (ascending) sort order. Examples in our guides.

sort_property'id' | 'updated_at'

Sort property of a list response. The default is id and thus the created_at order. If you sort by other properties, we additionally sort by id implicitly as a secondary sort property, so that you can rely on the sort order to be deterministic even if the main sort property ends up with the same values.

Response

OK

idinteger

Send Action ID

public_idstring nullable

Send Action public ID

workspace_idinteger

Workspace ID

send_type'default' | 'split_test_main' | 'split_test_variant' | 'split_test_winner' | 'send_in_contacts_time_zone' | 'schedule_send_in_contacts_time_zone'

The delivery strategy used for this send action.

target_idsinteger[] nullable

Array of broadcast IDs targeted by this send action. For a standard broadcast send, this contains the single broadcast ID being delivered.

target_countinteger nullable

Total number of contacts targeted by this send action. null until the async job has resolved the audience count.

performed_countinteger nullable

Number of contacts processed so far. Poll alongside target_count to track async delivery progress.

scheduled_forstring date-time nullable

Datetime the send is scheduled to begin. Reflects the send_at passed at creation, adjusted to the workspace time zone. null for immediate sends.

started_atstring date-time nullable

Datetime the async delivery job began processing contacts. null until the job has started.

completed_atstring date-time nullable

Datetime the async delivery job finished. null until delivery is complete.

created_by_idinteger nullable

Reserved; null in most cases. The member who triggered the send is recorded in approved_by_id instead.

approved_by_idinteger nullable

ID of the workspace membership that created/approved this send action — the member that triggered the send. Populated for API-created sends.

created_atstring date-time nullable

Created at datetime

updated_atstring date-time nullable

Updated at datetime

broadcast_idinteger nullable

The ID of the email broadcast being delivered. Convenience field derived from target_ids[0].

Example response

[
  {
    "id": 1,
    "public_id": "aB3cD4",
    "workspace_id": 42000,
    "send_type": "default",
    "target_ids": [
      7
    ],
    "target_count": 1500,
    "performed_count": 750,
    "scheduled_for": null,
    "started_at": "2025-06-01T18:00:05.000Z",
    "completed_at": null,
    "created_by_id": null,
    "approved_by_id": 3,
    "created_at": "2025-06-01T17:59:00.000Z",
    "updated_at": "2025-06-01T18:00:05.000Z",
    "broadcast_id": 7
  }
]

Changes

  • 511d88b30aeaRevision changes
    • info

      added the new optional query request parameter per_page

    • info

      for the path request parameter broadcast_id, the type was generalized from integer to string

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status