Twilio Voice Integration

Overview

Add Twilio Voice to any ModuleX agent or workflow. Make and manage phone calls with Twilio Programmable Voice — place outbound calls driven by TwiML, list call logs, and retrieve call recordings against the Twilio REST API (api.twilio.com/2010-04-01).

Categories: Communication · Messaging · Text To Speech · Auth: Account SID & Auth Token · Actions: 3

Authentication

Account SID & Auth Token

Authenticate with your Twilio Account SID and Auth Token using HTTP Basic authentication

Step 1

Step 2

On the dashboard, find your Account SID (starts with ‘AC’)

Step 3

Reveal and copy your Auth Token

Step 4

Provide the Account SID and Auth Token below

Required Credentials

Field	Description	Required	Format
Twilio Account SID	Your Twilio Account SID from the Twilio Console	Yes	`ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
Twilio Auth Token	Your Twilio Auth Token from the Twilio Console	Yes	`your_auth_token`

Available Actions

make_call — Make an outbound phone call using the Twilio Voice API.

Parameters

string

required

Phone number to call in E.164 format (e.g., +14155551234)

string

required

Your Twilio phone number to call from in E.164 format (e.g., +14155559876)

string

required

Twilio Account SID (starts with ‘AC’)

string

Webhook URL that returns TwiML instructions for the call

string

TwiML instructions to execute (raw XML, e.g. ‘<Response><Say>Hello</Say></Response>’). Provide this or ‘url’.

string

Webhook URL for call status updates

string

HTTP method for the status callback (GET or POST)

boolean

Whether to record the call (Default: false)

string

Webhook URL for recording status updates

integer

Seconds to wait for an answer before giving up (default: 60)

string

Answering machine detection: ‘Enable’ or ‘DetectMessageEnd’

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "call_sid": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Call Sid"
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Status"
    },
    "direction": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Direction"
    },
    "from_": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "From"
    },
    "to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "To"
    },
    "duration": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Duration"
    },
    "price": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Price"
    },
    "price_unit": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Price Unit"
    }
  },
  "required": [
    "success"
  ],
  "title": "MakeCallOutput",
  "type": "object"
}

list_calls — Retrieve a list of calls made to and from a Twilio account.

Parameters

string

required

Twilio Account SID (starts with ‘AC’)

string

Filter by calls to this phone number (E.164 format)

string

Filter by calls from this phone number (E.164 format)

string

Filter by call status (queued, ringing, in-progress, completed, busy, failed, no-answer, canceled)

string

Filter calls that started on or after this date (YYYY-MM-DD)

string

Filter calls that started on or before this date (YYYY-MM-DD)

integer

Number of records to return (max 1000, default 50)

boolean

Whether to fetch recording SIDs for each returned call (adds one extra request per call that has recordings) (Default: true)

Response

{
  "$defs": {
    "CallListItem": {
      "additionalProperties": false,
      "description": "A single call row in ``list_calls``.",
      "properties": {
        "call_sid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Call Sid"
        },
        "from_": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "From"
        },
        "to": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "To"
        },
        "status": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Status"
        },
        "direction": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Direction"
        },
        "duration": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Duration"
        },
        "price": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Price"
        },
        "price_unit": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Price Unit"
        },
        "start_time": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Start Time"
        },
        "end_time": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "End Time"
        },
        "date_created": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Date Created"
        },
        "recording_sids": {
          "items": {
            "type": "string"
          },
          "title": "Recording Sids",
          "type": "array"
        }
      },
      "title": "CallListItem",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "calls": {
      "items": {
        "$ref": "#/$defs/CallListItem"
      },
      "title": "Calls",
      "type": "array"
    },
    "total": {
      "default": 0,
      "title": "Total",
      "type": "integer"
    },
    "page": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Page"
    },
    "page_size": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Page Size"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListCallsOutput",
  "type": "object"
}

get_recording — Retrieve call recording information by recording SID.

Parameters

string

required

Recording SID to retrieve (e.g., RExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx)

string

required

Twilio Account SID (starts with ‘AC’)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "recording_sid": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Recording Sid"
    },
    "call_sid": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Call Sid"
    },
    "duration": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Duration"
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Status"
    },
    "channels": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Channels"
    },
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Source"
    },
    "media_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Media Url"
    },
    "price": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Price"
    },
    "price_unit": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Price Unit"
    },
    "uri": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Uri"
    },
    "transcription_text": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Transcription Text"
    },
    "transcription_status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Transcription Status"
    },
    "transcription_price": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Transcription Price"
    },
    "transcription_price_unit": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Transcription Price Unit"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetRecordingOutput",
  "type": "object"
}

Limits & Quotas

Concurrency: outbound call throughput depends on your account tier and number of phone numbers; long calls and the call queue are subject to Twilio’s per-account limits.
List pagination: list_calls accepts page_size (max 1000, default 50); when include_recordings is enabled it issues one extra request per call that has recordings.
Pricing: per-minute voice rates and per-recording charges vary by destination and feature — see Twilio’s pricing pages.
Error model: non-2xx responses, timeouts, and Twilio error_code/message failures are caught and returned as success=False + error rather than raising. Plan retries on the agent side based on the error string.

Using

Providers

Building

Tools

Twilio Voice Integration for AI Agents & Workflows

Overview

Authentication

Account SID & Auth Token

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Slack

Telegram Bot

WhatsApp

Links

​Overview

​Authentication

​Account SID & Auth Token

​Required Credentials

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

Slack

Telegram Bot

WhatsApp

​Links

Overview

Authentication

Account SID & Auth Token

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Related integrations

Links