bird email competitive watchlist brands create

bird email competitive watchlist brands create <brand-id> [flags]

Add a competitor brand to the watchlist

Add a brand using the panel brand_id returned by brand search. The response id identifies the new workspace watchlist entry for reads and removal. Each entry uses one place in the organization-wide allowance and tracks the brand's highest-volume sending domain. Reuse an idempotency key when retrying the same addition.

API-key, OAuth, and service-account calls require Insights preview access for your organization.

Build the request from the <brand_id> argument, a JSON EmailCompetitiveWatchlistBrandCreate 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.

# print the body shape (no credentials needed)
bird email competitive watchlist brands create --example

# the body it prints:

{
  "brand_id": "81531"
}