Sign inGet started

bird numbers orders create

Usage

Exemple de code
bird numbers orders create [flags]

Description

Create a number order
Buys a number and starts its monthly charge. Most orders settle inline; one waiting on a carrier comes back pending and is followed with bird numbers orders get. A setup fee already taken is not refunded if the order then fails.
Build the request from flags, a JSON NumbersOrderCreate 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 3 of 5 of "Buy a phone number". Previous: bird numbers available get. Next: bird numbers orders get.

Examples

Exemple de code
# print the body shape (no credentials needed)
bird numbers orders create --example

# the body it prints:
Exemple de code
{
  "number": "+18005550100"
}

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

Options

NameDescription
--numberThe number to acquire, in E.164 format, as returned by GET /v1/numbers/available. (required; or in --body-file)
--response-schemaPrint the fields this command returns, then exit
NameDescription
bird numbers orders getGet a number order
bird numbers orders listList your number orders

Ressources associées

Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.

Obtenir un guide d'implémentation