Create verification codes for the hosted numbers order

POST 
/messaging_hosted_number_orders/:id/verification_codes

Create verification codes to validate numbers of the hosted order. The verification codes will be sent to the numbers of the hosted order.

Path Parameters

id stringrequired

Order ID to have a verification code created.

application/json

Body

Message payload

phone_numbers +E.164[]required
verification_method stringrequired

Possible values: [sms, call, flashcall]

201: Verification codes created and sent to the phone numbers of the hosted order.

application/json

• Schema

Schema

any

default: Unexpected error

application/json

• Schema
• Example (from schema)

Schema

errors

Error[]

Array [

code integerrequired

title stringrequired

detail string

source

object

pointer json-pointer

JSON pointer (RFC6901) to the offending entity.

parameter string

Indicates which query parameter caused the error.

meta object

]

{
  "errors": [
    {
      "code": "string",
      "title": "string",
      "detail": "string",
      "source": {
        "pointer": "string",
        "parameter": "string"
      },
      "meta": {}
    }
  ]
}

Request samples

• cURL

---

curl -L 'https://api.telnyx.com/v2/messaging_hosted_number_orders/:id/verification_codes' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
  "phone_numbers": [
    "string"
  ],
  "verification_method": "sms"
}'

Response samples

• default

---

{
  "errors": [
    {
      "code": "string",
      "title": "string",
      "detail": "string",
      "source": {
        "pointer": "string",
        "parameter": "string"
      },
      "meta": {}
    }
  ]
}