Documentation
Sign inGet started

bird sms destinations

Usage

Codebeispiel
bird sms destinations

Description

The allowlist is default-deny: a workspace starts with its organization's home country and nothing else, and a send to any country it has not enabled is refused before the sender is even resolved.
Reads return JSON. Mutations take flags and/or a --body-file JSON body (flags overriding); run --example to print the body shape or --dry-run to preview the request.

Procedure

Enable the countries a workspace may send SMS to
Every SMS send passes the workspace's destination allowlist before anything else about it is considered. It is default-deny: a workspace starts with its organization's home country and nothing more, so reaching any other country is an explicit change. Read the list to see what is enabled and what Bird can deliver, then enable what you need.
  1. bird sms destinations list — Returns every country Bird carries SMS to, each with the workspace's enabled setting and Bird's own deliverability for it. The two are independent — enabling a country Bird does not carry does not make it sendable. Small and returned in full; not paginated. Next: bird sms destinations update
  2. bird sms destinations update — Only the countries you list change; any you omit keep their current setting. A code Bird does not carry is rejected and nothing changes. Disabling a country stops every send there, so confirm a disable with the user first. Next: bird sms send

Commands

NameDescription
listList SMS destination countries
updateUpdate enabled SMS destination countries