`bird whatsapp broadcasts validate`

Usage

Code example

bird whatsapp broadcasts validate <broadcast-id> [flags]

Description

Check whether a WhatsApp broadcast can send

Reports every problem at once, including an audience larger than the from number's messaging limit. Nothing is saved.

Build the request from the <broadcast_id> argument and flags, a JSON WhatsAppBroadcastValidationRequest 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 4 of 8 of "Check, test and send a WhatsApp broadcast". Previous: bird whatsapp templates versions get. Next: bird whatsapp broadcasts pricing-estimate.

Examples

Code example

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

# the body it prints:

Code example

{
  "template": {
    "language": "es",
    "parameters": {
      "header_url": "https://cdn.example.com/fall.jpg",
      "promo_code": "FALL26"
    }
  }
}

Options

Request

Name	Description
`--body-file`	Read the JSON request body from this file; "-" reads stdin
`--example`	Print a complete example request body, then exit
`--dry-run`	Print the resolved request without sending it, then exit
`--idempotency-key`	Accepted for this POST request. Each call computes a fresh result; reusing the key does not replay an earlier result.

Options

Name	Description
`--language`	Override the language: One of the template's languages, such as en-US. Omit it to choose each recipient's language from their phone number's country
`--parameters`	Override the parameters. Template inputs as one JSON object, such as {"promo_code":"FALL25"}; replaces the whole map
`--response-schema`	Print the fields this command returns, then exit

Name	Description
`bird whatsapp broadcasts cancel`	Cancel a WhatsApp broadcast
`bird whatsapp broadcasts counts`	Get a WhatsApp broadcast's audience counts
`bird whatsapp broadcasts create`	Create a WhatsApp broadcast
`bird whatsapp broadcasts delete`	Delete a WhatsApp broadcast
`bird whatsapp broadcasts get`	Get a WhatsApp broadcast
`bird whatsapp broadcasts list`	List WhatsApp broadcasts
`bird whatsapp broadcasts list-recipients`	List recipients of a WhatsApp broadcast
`bird whatsapp broadcasts preview`	Render a WhatsApp broadcast's message
`bird whatsapp broadcasts pricing-estimate`	Estimate the cost of a WhatsApp broadcast
`bird whatsapp broadcasts send`	Send a WhatsApp broadcast
`bird whatsapp broadcasts send-quota`	Get the messaging limit for a WhatsApp broadcast
`bird whatsapp broadcasts test`	Send a WhatsApp broadcast's previewed message to one number
`bird whatsapp broadcasts update`	Update a draft or scheduled WhatsApp broadcast

Continue with the documentation, guides and examples for this topic.

Get an implementation brief

Related resources