API Docs / Schemas / EmailBroadcastAudienceRequest

EmailBroadcastAudienceRequest

The client-selection part of an email broadcast, used to summarise the audience
before a draft exists. Same selection semantics as create: a saved view or an
inline filter (mutually exclusive), plus hand-picked additions and exclusions.
Optionally include the To-recipient configuration to also count clients with
no resolvable email address.

Properties

Name Type Description
savedViewCodestring

The code of a saved client view whose filter selects which clients to include.
Mutually exclusive with Filter.

The code of a saved client view whose filter selects which clients to include.
Mutually exclusive with Filter.

filterEmailBroadcastFilterDto
excludedClientCodesarray of string

Client codes to exclude from the filter results.

Client codes to exclude from the filter results.

additionalClientCodesarray of string

Hand-picked client codes to add on top of the filter results.

Hand-picked client codes to add on top of the filter results.

allContactsboolean

When true, every contact of each client with an email address is a To recipient.
Part of the optional To-recipient configuration used to count clients with no
resolvable email address (NoEmailCount).

When true, every contact of each client with an email address is a To recipient.
Part of the optional To-recipient configuration used to count clients with no
resolvable email address (NoEmailCount).

recipientIncludeBusinessEmailboolean

Whether each client's business email (the email address on the client record) is a
To recipient. Part of the optional To-recipient configuration.

Whether each client's business email (the email address on the client record) is a
To recipient. Part of the optional To-recipient configuration.

recipientContactTypesarray of enum

Client contact types for To recipients. Part of the optional To-recipient configuration.

Main Billing Payroll Accounts Director Psc

Client contact types for To recipients. Part of the optional To-recipient configuration.

Main Billing Payroll Accounts Director Psc

recipientUserTypesarray of enum

User types for To recipients. Part of the optional To-recipient configuration.

TaskOwner SpecificUser ClientManager ClientServiceManager ClientPartner ClientAssociate DoNotAssign

User types for To recipients. Part of the optional To-recipient configuration.

TaskOwner SpecificUser ClientManager ClientServiceManager ClientPartner ClientAssociate DoNotAssign

additionalEmailAddressesarray of string

Static email addresses included as To recipients on every email.
Part of the optional To-recipient configuration.

Static email addresses included as To recipients on every email.
Part of the optional To-recipient configuration.

JSON Example

{
  "savedViewCode": "string",
  "filter": {
    "managerCodes": [
      "..."
    ],
    "partnerCodes": [
      "..."
    ],
    "associateCodes": [
      "..."
    ],
    "statuses": [
      "..."
    ],
    "types": [
      "..."
    ]
  },
  "excludedClientCodes": [
    "string"
  ],
  "additionalClientCodes": [
    "string"
  ],
  "allContacts": false
}

Used By Operations