Skip to main content
POST
Add a monitored number

Authorizations

Authorization
string
header
required

OptimalDial API key, prefixed od_live_, sent as Authorization: Bearer .... Mint keys in the in-app developer panel; they are scoped to a single organization.

Body

application/json
phone_number
string
required

Any common format. Normalized to E.164. Must be US or Canadian.

Example:

"+15551234567"

verification_method
enum<string>
default:call

How to deliver the verification code. call (default) works for any number; sms is only valid for SMS-capable numbers and returns 400 on a landline.

Available options:
call,
sms

Response

Number added; verification auto-sent.

number
object
required
verification
object
required