For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Log inSign up
Support
  • Core
    • Overview
    • Authorization
    • Base URL
    • Data formats
    • Paging
    • Error codes
    • Permissions
  • Calling
  • Datasphere
  • Logs
  • Messaging
  • Phone Number Management
  • Platform
      • POSTRequest MFA token via call
      • POSTRequest MFA token via SMS
      • POSTVerify MFA token
  • Resource Management
LogoLogoSignalWire Docs
Log inSign up
Support
PlatformMulti Factor Authentication

Request MFA token via call

|View as Markdown|Open in Claude|
POST
https://{your_space_name}.signalwire.com/api/relay/rest/mfa/call
POST
/api/relay/rest/mfa/call
$curl -X POST https://{your_space_name}.signalwire.com/api/relay/rest/mfa/call \
>     -H "Content-Type: application/json" \
>     -u "<project_id>:<api_token>" \
>     -d '{
>  "to": "+14043287382"
>}'
1{
2  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3  "success": true,
4  "to": "+15554422333",
5  "channel": "call"
6}

Sends a multi-factor authentication code via voice call.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Management.

Learn more about API scopes.

Was this page helpful?
Previous

Request MFA token via SMS

Next
Built with

Authentication

AuthorizationBasic
SignalWire Basic Authentication using Project ID and API Token. The client sends HTTP requests with the Authorization header containing the word Basic followed by a space and a base64-encoded string of project_id:token. The project ID will be used as the username and the API token as the password. Example: ``` Authorization: Basic base64(project_id:token) ```

Request

This endpoint expects an object.
tostringRequired
The E164 number to use as the destination.
fromstringOptional
The E164 number from your account to use as the origin of the message. SignalWire will use a special verified number if not specified.
messagestringOptionalDefaults to Your Personal Authorization Code is:

Specify a custom message to send before the token. The message must fit within one segment; either 160 characters or 70 characters when using non-GSM symbols.

token_lengthintegerOptionalDefaults to 6
The number of characters in the token, from 4 to 20. Defaults to 6.
valid_forintegerOptionalDefaults to 3600
The number of seconds the token is considered valid for. Defaults to 3600, with a maximum of 604800.
max_attemptsintegerOptionalDefaults to 3
The number of allowed verification attempts, including the first one, from 1 to 20. Defaults to 3.
allow_alphasbooleanOptionalDefaults to false

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

Response

The request has succeeded.
idstringformat: "uuid"
The MFA request ID. Save this for verification.
successboolean
Whether the request was successfully queued.
tostring
The destination of the MFA request.
channelstring
Can be sms for a text message or call for a phone call.

Errors

401
Unauthorized Error
422
Unprocessable Entity Error
500
Internal Server Error

SignalWire Basic Authentication using Project ID and API Token.

The client sends HTTP requests with the Authorization header containing the word Basic followed by a space and a base64-encoded string of project_id:token. The project ID will be used as the username and the API token as the password.

Example:

Authorization: Basic base64(project_id:token)