Sign inGet Started

bird email broadcasts validate

Usage

Codebeispiel
bird email broadcasts validate <broadcast-id> [flags]

Description

validate a broadcast

Check the saved broadcast or the changes supplied in this request against the template's published content, without saving changes, selecting a template version for sending or evaluating recipients. Requires broadcast and template read permission.

Build the request from the <broadcast_id> argument and flags, a JSON EmailBroadcastValidationRequest body via --body-file ("-" reads stdin), or both — an inline value overrides the matching body field. Run --example to print a ready-to-edit body, or --dry-run to print the resolved request without sending it.

Procedure

Step 3 of 5 of "Preview and test a broadcast". Previous: bird email templates parameters. Next: bird email broadcasts preview.

Examples

Codebeispiel
# print the body shape (no credentials needed)
bird email broadcasts validate --example

# the body it prints:
Codebeispiel
{
  "from": "Jane Doe <jane@acme.com>",
  "headers": {
    "X-Campaign": "spring-launch"
  }
}

Options

Request

NameDescription
--body-fileRead the JSON request body from this file; "-" reads stdin
--examplePrint a complete example request body, then exit
--dry-runPrint the resolved request without sending it, then exit
--idempotency-keyAccepted for this POST request. Each call computes a fresh result; reusing the key does not replay an earlier result.

Options

NameDescription
--templateOverride the template ID
--languageOverride the selected template language
--parametersComplete authored template input map as JSON; {} clears the map
--parameter-overridesComplete per-language override map as JSON; a name a language leaves out uses --parameters, and {} clears every override
--fromOverride sender address
--reply-to <value>…Override reply address; repeatable
--header <key=value>Replace headers as Key=Value
--response-schemaPrint the fields this command returns, then exit
NameDescription
bird email broadcasts cancelCancel a broadcast
bird email broadcasts countsGet a broadcast's audience counts
bird email broadcasts createCreate a broadcast
bird email broadcasts deleteDelete a broadcast
bird email broadcasts getGet a broadcast
bird email broadcasts listList broadcasts
bird email broadcasts list-clicked-linksList a broadcast's clicked links
bird email broadcasts list-eventsList events for a broadcast
bird email broadcasts list-recipientsList recipients of a broadcast
bird email broadcasts previewpreview a broadcast
bird email broadcasts sendSend a broadcast
bird email broadcasts send-quotaGet the email send allowance for a broadcast
bird email broadcasts testtest a broadcast
bird email broadcasts updateUpdate a draft or scheduled broadcast

Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.