bird sms senders create

Usage

Przykład kodu

bird sms senders create [flags]

Claims an alphanumeric sender for this workspace. Claiming costs nothing. Countries with registration_mode none or optional allow sending when the destination is enabled, subject to their sender-type rules. Required registration must be approved first. Read bird sms senders requirements for registration_mode, current registration progress, and expected sender_id_behavior, including whether the sender ID is overwritten.

Build the request from flags, a JSON SMSSenderCreate body via --body-file ("-" reads stdin), or both — a flag 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 1 of 3 of "Claim an SMS sender and register it for a country". Next: bird sms senders requirements.

Examples

Przykład kodu

# print the body shape (no credentials needed)
bird sms senders create --example

# the body it prints:

Przykład kodu

{
  "sender": "BIRD",
  "type": "alpha"
}

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	Deduplication key; a retry with the same key won't act twice

Options

Name	Description
--type	The kind of sender to create. Only alpha (an alphanumeric sender string) is customer-creatable. Dedicated numbers become senders when you allocate them from inventory. This endpoint cannot create their senders. Possible values: alpha. (required; or in --body-file)
--sender	The alphanumeric sender string to create, for example 'BIRD'. 3–11 letters, digits, spaces, dashes, underscores, or dots, at least one of them a letter, and no separator at either end. (required; or in --body-file)
--response-schema	Print the fields this command returns, then exit

Name	Description
bird sms senders get	Get an SMS sender
bird sms senders list	List your SMS senders
bird sms senders requirements	List what a sender needs to send

Powiązane zasoby

Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.

Obejrzyj przewodnikRegistering your SMS sender ID Zrozum koncepcjęWhat is sender ID registration, and why do some countries require it?Poznaj możliwościSMS sender IDs Podążaj ścieżką naukiBuild your first integration

Uzyskaj brief wdrożeniowy