OptionalareaRequired attestation that the account holder explicitly consented to provisioning this number programmatically (e.g. a reference to where/how they consented). Stored on the number for the provisioning audit trail.
System prompt the AI voice agent uses on inbound calls to this number. Required.
OptionalinboundBCP-47 language tag (e.g. "es-ES") pinning inbound calls to this number to one language. Optional — omitted: the language is detected from the caller's country prefix on each call (alongside en-US).
OptionalinboundVoice gender for inbound calls to this number: "male" or "female". Optional — omitted: female (the default for every language).
OptionalincludeProvision an iMessage number instead of a standard one. Optional — omitted:
a standard SMS/call number. iMessage numbers are pay-as-you-go only and are
provisioned asynchronously: the returned number starts in setupStatus: "provisioning" — poll DialClient.listNumbers until it is "ready".
Preferred US area code when provisioning. Optional — omitted: any available US number. Only US numbers can be provisioned at this time. Ignored for iMessage numbers.