Docs

List Analytics Publications

See a page's publications: who each one sends to, where, and when it sends next. Only the page's owner can list them.

GET

Path

Path parameters
stringrequired

The page id, from List Analytics Pages.

Headers

Optional headers
string

Optional. The id of the organization to act in. Leave it out to act in the API key's own organization. Here a key acts in another organization only as one of its members: with "Use this key across all of your organizations" on, in an organization its creator belongs to with a role. Child organizations and MindCloud staff access do not reach this endpoint. Every response's X-Company-Id header names the organization it acted in. See Organizations.

Query

FiltersNarrow list results with a provider-supported where expression. Learn more
string

RSQL expression used to filter list results.

PaginationRequest a specific window of rows with limit and offset. Learn more
number

Maximum number of rows to return.

number

Number of rows to skip.

SortingChoose the order of returned rows when this action supports sorting. Learn more
string

Comma-separated sort fields; prefix with - for descending.

Field selectionChoose which fields should be included in the response. Learn more
string

Comma-separated response fields to include.

Response fields

idstring

The publication's id.

pageIdstring

The page it sends, from List Analytics Pages.

namestring

Its name. Null until one is given.

isActiveboolean

True when it sends on its schedule. A new publication starts paused.

channelstring

Where it sends.

  • emailEmail to the recipients, from MindCloud or from a Gmail or Outlook connection.
  • slackA message in a Slack channel, sent with a Slack connection.
  • teamsA message in a Microsoft Teams channel, sent with a Microsoft Teams connection.
scheduleTypestring

How its schedule is set.

  • fixedOn the weekdays in days, at each time in runTimes.
  • intervalEvery intervalMinutes, starting at the first time in runTimes.
  • monthlyOn the days of the month in monthDays, at each time in runTimes.
  • onceOnce, on the date in runDates, at the time in runTimes.
intervalMinutesnumber

For interval: minutes between sends, 360 (six hours) to 43200 (thirty days).

daysarray of number

For fixed: the weekdays it sends on, 0 (Sunday) to 6 (Saturday).

monthDaysarray of number

For monthly: the days of the month it sends on, 1 to 30, or -1 for the last day.

runDatesarray of string

For once: the date it sends on, as YYYY-MM-DD.

runTimesarray of string

The times of day it sends at, as HH:MM in timeZone.

timeZonestring

The IANA time zone its times are in, such as America/New_York.

isOrganizationTimeZoneboolean

True when timeZone is the organization's time zone and changes with it; false when one was set for this publication.

nextRunOndate

When it sends next. Null while it is paused or has nothing left to send.

autoPausedOndate

When MindCloud paused it after failed sends. Null when it was not.

autoPauseReasonstring

Why MindCloud paused it. Null when it was not.

recipientUserIdsarray of string

Member recipients, by user id (from List Members).

externalRecipientsarray of string

Recipients outside the organization, by email address.

unsubscribedRecipientUserIdsarray of string

Members who unsubscribed with the link in its email, by user id. They get nothing until resubscribed.

unsubscribedExternalRecipientsarray of string

Outside addresses that unsubscribed with the link in its email.

subjectstring

The email subject. Null uses the page's name.

connectionIdstring

The connection it sends through, from List Connections. Null for email from MindCloud's own sender.

destinationobject

For slack and teams: where it posts. Null for email.

  • channelIdstring

    Slack and Teams: the channel id it posts in. Null for email.

  • channelLabelstring

    Slack and Teams: the channel name, as picked. Null for email.

  • teamIdstring

    Teams: the team id. Null otherwise.

  • teamLabelstring

    Teams: the team name, as picked. Null otherwise.

variablesobject

Its own filter values, by page variable name, as the page's link carries them. Empty uses the page's defaults.

createdOndate

When it was created.

updatedOndate

When it last changed.