Skip to main content

Request a MFA token via phone call

POST 
/mfa/call

Request a MFA token via phone call

Permissions​

The API token must include one of the following scopes: Voice or Messaging or Fax.

Request​

Body

required

    tostringrequired

    The E164 number to use as the destination.

    Example: +14043287382
    fromstring

    The E164 number from your account to use as the origin of the call. SignalWire will use a special verified number if not specified. If using a different caller ID, make sure it is a number you have purchased or have verified on your SignalWire account.

    Example: +12029167968
    messagestring

    The message to play to the caller before the token is read. The message must be at most 500 characters. Defaults to "Your Personal Authorization Code is".

    Example: Here is your code
    token_lengthnumber

    The number of characters in the token, from 4 to 20. Defaults to 6.

    Example: 6
    max_attemptsnumber

    The number of allowed verification attempts, including the first one, from 1 to 20. Defaults to 3.

    Example: 3
    allow_alphasboolean

    Set to true or false, whether to include letters or just numbers in the token. Defaults to false (numbers only).

    Example: false
    valid_fornumber

    The number of seconds the token is considered valid for. Defaults to 3600, with a maximum of 604800.

    Example: 3600

Responses​

OK

Schema

    iduuid

    The MFA request ID. Save this for verification.

    successboolean

    Whether the request was successfully queued.

    Example: true
    tostring

    The destination of the MFA request.

    Example: +15554422333
    channelstring

    Can be sms for a text message or call for a phone call.

    Example: call
Last updated on