> For the complete documentation index, see [llms.txt](https://docs.planetcrust.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.planetcrust.com/human-connections/twilio/twilio.md).

# Twilio

<p align="center"><a class="button primary" data-icon="circle-caret-right">Try @Human</a><a class="button primary" data-icon="check">Buy @Human Subscription</a><a class="button primary" data-icon="comments">Join @Human Community</a></p>

<figure><img src="/files/BsMm0Q3OoJl0xF3mMe8H" alt=""><figcaption></figcaption></figure>

<h3 align="center">Put Twilio to Work with @Human Automations and @Human Agents</h3>

<p align="center">The Twilio Connection documents all Triggers, Actions and Query Operations available for creating automations via the Twilio API.</p>

{% embed url="<https://www.youtube.com/watch?v=CyuUuaBSZzA>" %}

#### What can you do with the Twilio Connection?

* Connect to the Twilio API in a few clicks
* Use the related Twilio Operations (see below) in @Human Automations or @Human Agents

### Related Operations

#### Trigger Operations

**Message Received**

Triggers on: messages/message\_received

Triggered when a new message is received via Twilio.

**Call Received**

Triggers on: calls/call\_received

Triggered when a new call is received via Twilio.

#### Action Operations

[Action: Call Phone](/human-connections/twilio/twilio/action-call-phone.md)

[Action: Send SMS](/human-connections/twilio/twilio/action-send-sms.md)

[Action: Send WhatsApp Message](/human-connections/twilio/twilio/action-send-whatsapp-message.md)

[Action: API Request](/human-connections/twilio/twilio/action-api-request.md)

#### Query Operations

Example link

### Related Automations

Example link

### Obtaining Access Credentials <a href="#obtaining-access-credentials" id="obtaining-access-credentials"></a>

To obtain a **Twilio Personal Access Token (PAT)** for system-to-system access, provide the following:

1. **Twilio Account SID** (Found in the Twilio Console Dashboard)
2. **Twilio Auth Token** (Found in the Twilio Console Dashboard, under "Auth Token")

#### Steps to Generate a Twilio PAT:

1. **Log in** to your [Twilio Console](https://console.twilio.com/) (Requires a Twilio account with admin/subscription access).
2. Navigate to **Settings** (Gear icon) → **API Keys & Tokens**.
3. Under **Personal Access Tokens**, click **Create Token**.
4. Assign a **Friendly Name** (e.g., "System-to-System Access").
5. Select the required **Scopes** (e.g., `api:read`, `api:write`).
6. Click **Create Token**.
7. **Copy the generated PAT** (displayed once; store securely).

### Configuring Webhooks

1. **Log in** to the [Twilio Console](https://console.twilio.com/).
2. Navigate to **Phone Numbers** > **Manage** > **Active Numbers**.
3. Select the **Phone Number** you wish to configure.
4. Scroll to the **Voice & Fax** or **Messaging** section.
5. Change the dropdown for **A CALL COMES IN** or **A MESSAGE COMES IN** to **Webhook**.
6. Paste your **Webhook URL** into the URL field.
7. Ensure the HTTP method is set to **HTTP POST**.
8. Click **Save** to apply the configuration.

### Code (Apache v2.0): Service Connectivity and Metadata

```
{
  "handle": "twilio",
  "status": "active",
  "meta": {
    "short": "Twilio",
    "description": "A connector for interacting with Twilio's communication APIs.",
    "icon": "twilio",
    "tags": ["communication", "sms", "voice", "api"]
  },
  "service": {
    "baseURL": {
      "value": "https://api.twilio.com/2010-04-01"
    },
    "protocol": "https",
    "contentType": "application/x-www-form-urlencoded",
    "headers": {
      "Accept": {
        "value": "application/json"
      }
    },
    "auth": {
      "method": "basic",
      "params": {
        "basic": {
          "username": {
            "value": "{{AccountSID}}",
            "placeholders": [
              {
                "name": "AccountSID",
                "type": "String",
                "description": "Twilio Account SID",
                "required": true
              }
            ]
          },
          "password": {
            "value": "{{AuthToken}}",
            "placeholders": [
              {
                "name": "AuthToken",
                "type": "String",
                "description": "Twilio Auth Token",
                "required": true
              }
            ]
          }
        }
      }
    }
  }
}

```

### Code (Apache v2.0): List of External Resources and Internal Mapping

```
[
  {
    "handle": "messages",
    "meta": {
      "short": "Messages",
      "description": "Send and receive SMS and MMS messages"
    },
    "endpoint": {
      "value": "/Messages.json",
      "placeholders": []
    },
    "fields": [
      {
        "name": "sid",
        "type": "string",
        "selector": [
          "sid"
        ],
        "meta": {
          "description": "The unique string that identifies the resource"
        }
      },
      {
        "name": "body",
        "type": "string",
        "selector": [
          "body"
        ],
        "meta": {
          "description": "The text body of the message"
        }
      },
      {
        "name": "from",
        "type": "string",
        "selector": [
          "from"
        ],
        "meta": {
          "description": "The phone number that initiated the message"
        }
      },
      {
        "name": "to",
        "type": "string",
        "selector": [
          "to"
        ],
        "meta": {
          "description": "The phone number that received the message"
        }
      },
      {
        "name": "status",
        "type": "string",
        "selector": [
          "status"
        ],
        "meta": {
          "description": "The status of the message"
        }
      }
    ],
    "operations": {
      "list": {
        "method": "GET",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "read": {
        "method": "GET",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The SID of the message to fetch",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "create": {
        "method": "POST",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": {
          "value": "{\"Body\": \"{{body}}\", \"From\": \"{{from}}\", \"To\": \"{{to}}\"}",
          "placeholders": [
            {
              "name": "body",
              "type": "String",
              "description": "The text body of the message",
              "required": true
            },
            {
              "name": "from",
              "type": "String",
              "description": "The phone number sending the message",
              "required": true
            },
            {
              "name": "to",
              "type": "String",
              "description": "The phone number receiving the message",
              "required": true
            }
          ]
        }
      },
      "update": {
        "method": "POST",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The SID of the message to update",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": {
          "value": "{\"Status\": \"{{status}}\"}",
          "placeholders": [
            {
              "name": "status",
              "type": "String",
              "description": "The new status of the message",
              "required": true
            }
          ]
        }
      },
      "delete": null
    },
    "webhooks": [
      {
        "event": "message_received",
        "path": "/webhooks/twilio/messages",
        "payload": [
          {
            "name": "sid",
            "type": "string",
            "selector": [
              "MessageSid"
            ],
            "meta": {
              "description": "The unique string that identifies the message"
            }
          },
          {
            "name": "body",
            "type": "string",
            "selector": [
              "Body"
            ],
            "meta": {
              "description": "The text body of the message"
            }
          },
          {
            "name": "from",
            "type": "string",
            "selector": [
              "From"
            ],
            "meta": {
              "description": "The phone number that initiated the message"
            }
          },
          {
            "name": "to",
            "type": "string",
            "selector": [
              "To"
            ],
            "meta": {
              "description": "The phone number that received the message"
            }
          }
        ]
      }
    ]
  },
  {
    "handle": "calls",
    "meta": {
      "short": "Calls",
      "description": "Make and receive phone calls"
    },
    "endpoint": {
      "value": "/Calls.json",
      "placeholders": []
    },
    "fields": [
      {
        "name": "sid",
        "type": "string",
        "selector": [
          "sid"
        ],
        "meta": {
          "description": "The unique string that identifies the resource"
        }
      },
      {
        "name": "from",
        "type": "string",
        "selector": [
          "from"
        ],
        "meta": {
          "description": "The phone number that initiated the call"
        }
      },
      {
        "name": "to",
        "type": "string",
        "selector": [
          "to"
        ],
        "meta": {
          "description": "The phone number that received the call"
        }
      },
      {
        "name": "status",
        "type": "string",
        "selector": [
          "status"
        ],
        "meta": {
          "description": "The status of the call"
        }
      }
    ],
    "operations": {
      "list": {
        "method": "GET",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "read": {
        "method": "GET",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The SID of the call to fetch",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "create": {
        "method": "POST",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": {
          "value": "{\"Url\": \"{{url}}\", \"From\": \"{{from}}\", \"To\": \"{{to}}\"}",
          "placeholders": [
            {
              "name": "url",
              "type": "String",
              "description": "The URL Twilio will request when the call connects",
              "required": true
            },
            {
              "name": "from",
              "type": "String",
              "description": "The phone number making the call",
              "required": true
            },
            {
              "name": "to",
              "type": "String",
              "description": "The phone number receiving the call",
              "required": true
            }
          ]
        }
      },
      "update": {
        "method": "POST",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The SID of the call to update",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": {
          "value": "{\"Status\": \"{{status}}\"}",
          "placeholders": [
            {
              "name": "status",
              "type": "String",
              "description": "The new status of the call",
              "required": true
            }
          ]
        }
      },
      "delete": null
    },
    "webhooks": [
      {
        "event": "call_received",
        "path": "/webhooks/twilio/calls",
        "payload": [
          {
            "name": "sid",
            "type": "string",
            "selector": [
              "CallSid"
            ],
            "meta": {
              "description": "The unique string that identifies the call"
            }
          },
          {
            "name": "from",
            "type": "string",
            "selector": [
              "From"
            ],
            "meta": {
              "description": "The phone number that initiated the call"
            }
          },
          {
            "name": "to",
            "type": "string",
            "selector": [
              "To"
            ],
            "meta": {
              "description": "The phone number that received the call"
            }
          }
        ]
      }
    ]
  },
  {
    "handle": "accounts",
    "meta": {
      "short": "Accounts",
      "description": "Manage Twilio Accounts"
    },
    "endpoint": {
      "value": "/Accounts.json",
      "placeholders": []
    },
    "fields": [
      {
        "name": "sid",
        "type": "string",
        "selector": [
          "sid"
        ],
        "meta": {
          "description": "The unique string that identifies the resource"
        }
      },
      {
        "name": "friendly_name",
        "type": "string",
        "selector": [
          "friendly_name"
        ],
        "meta": {
          "description": "A descriptive string that identifies this resource"
        }
      },
      {
        "name": "status",
        "type": "string",
        "selector": [
          "status"
        ],
        "meta": {
          "description": "The status of the account"
        }
      },
      {
        "name": "type",
        "type": "string",
        "selector": [
          "type"
        ],
        "meta": {
          "description": "The type of account"
        }
      }
    ],
    "operations": {
      "list": {
        "method": "GET",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "read": {
        "method": "GET",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "create": {
        "method": "POST",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "update": {
        "method": "POST",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "delete": null
    }
  },
  {
    "handle": "addresses",
    "meta": {
      "short": "Addresses",
      "description": "Manage customer addresses"
    },
    "endpoint": {
      "value": "/Addresses.json",
      "placeholders": []
    },
    "fields": [
      {
        "name": "sid",
        "type": "string",
        "selector": [
          "sid"
        ],
        "meta": {
          "description": "The unique string that identifies the resource"
        }
      },
      {
        "name": "customer_name",
        "type": "string",
        "selector": [
          "customer_name"
        ],
        "meta": {
          "description": "The name to associate with the address"
        }
      },
      {
        "name": "street",
        "type": "string",
        "selector": [
          "street"
        ],
        "meta": {
          "description": "The number and street address"
        }
      },
      {
        "name": "city",
        "type": "string",
        "selector": [
          "city"
        ],
        "meta": {
          "description": "The city of the address"
        }
      },
      {
        "name": "region",
        "type": "string",
        "selector": [
          "region"
        ],
        "meta": {
          "description": "The state or region of the address"
        }
      },
      {
        "name": "postal_code",
        "type": "string",
        "selector": [
          "postal_code"
        ],
        "meta": {
          "description": "The postal code of the address"
        }
      },
      {
        "name": "iso_country",
        "type": "string",
        "selector": [
          "iso_country"
        ],
        "meta": {
          "description": "The ISO country code of the address"
        }
      }
    ],
    "operations": {
      "list": {
        "method": "GET",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "read": {
        "method": "GET",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "create": {
        "method": "POST",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "update": {
        "method": "POST",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "delete": {
        "method": "DELETE",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      }
    }
  },
  {
    "handle": "applications",
    "meta": {
      "short": "Applications",
      "description": "Manage TwiML applications"
    },
    "endpoint": {
      "value": "/Applications.json",
      "placeholders": []
    },
    "fields": [
      {
        "name": "sid",
        "type": "string",
        "selector": [
          "sid"
        ],
        "meta": {
          "description": "The unique string that identifies the resource"
        }
      },
      {
        "name": "friendly_name",
        "type": "string",
        "selector": [
          "friendly_name"
        ],
        "meta": {
          "description": "A descriptive string that identifies this resource"
        }
      },
      {
        "name": "api_version",
        "type": "string",
        "selector": [
          "api_version"
        ],
        "meta": {
          "description": "The API version used to start a new TwiML session"
        }
      },
      {
        "name": "voice_url",
        "type": "string",
        "selector": [
          "voice_url"
        ],
        "meta": {
          "description": "The URL we should call when the phone number receives a call"
        }
      },
      {
        "name": "sms_url",
        "type": "string",
        "selector": [
          "sms_url"
        ],
        "meta": {
          "description": "The URL we should call when the phone number receives an incoming SMS message"
        }
      }
    ],
    "operations": {
      "list": {
        "method": "GET",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "read": {
        "method": "GET",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "create": {
        "method": "POST",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "update": {
        "method": "POST",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "delete": {
        "method": "DELETE",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      }
    }
  },
  {
    "handle": "incoming_phone_numbers",
    "meta": {
      "short": "Incoming Phone Numbers",
      "description": "Manage incoming phone numbers"
    },
    "endpoint": {
      "value": "/IncomingPhoneNumbers.json",
      "placeholders": []
    },
    "fields": [
      {
        "name": "sid",
        "type": "string",
        "selector": [
          "sid"
        ],
        "meta": {
          "description": "The unique string that identifies the resource"
        }
      },
      {
        "name": "phone_number",
        "type": "string",
        "selector": [
          "phone_number"
        ],
        "meta": {
          "description": "The phone number with formatting"
        }
      },
      {
        "name": "friendly_name",
        "type": "string",
        "selector": [
          "friendly_name"
        ],
        "meta": {
          "description": "A descriptive string that identifies this resource"
        }
      },
      {
        "name": "voice_url",
        "type": "string",
        "selector": [
          "voice_url"
        ],
        "meta": {
          "description": "The URL we should call when the phone number receives a call"
        }
      },
      {
        "name": "sms_url",
        "type": "string",
        "selector": [
          "sms_url"
        ],
        "meta": {
          "description": "The URL we should call when the phone number receives an incoming SMS message"
        }
      }
    ],
    "operations": {
      "list": {
        "method": "GET",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "read": {
        "method": "GET",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "create": {
        "method": "POST",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "update": {
        "method": "POST",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "delete": {
        "method": "DELETE",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      }
    }
  },
  {
    "handle": "recordings",
    "meta": {
      "short": "Recordings",
      "description": "Manage call recordings"
    },
    "endpoint": {
      "value": "/Recordings.json",
      "placeholders": []
    },
    "fields": [
      {
        "name": "sid",
        "type": "string",
        "selector": [
          "sid"
        ],
        "meta": {
          "description": "The unique string that identifies the resource"
        }
      },
      {
        "name": "call_sid",
        "type": "string",
        "selector": [
          "call_sid"
        ],
        "meta": {
          "description": "The SID of the Call that the recording is associated with"
        }
      },
      {
        "name": "duration",
        "type": "string",
        "selector": [
          "duration"
        ],
        "meta": {
          "description": "The length of the recording in seconds"
        }
      },
      {
        "name": "status",
        "type": "string",
        "selector": [
          "status"
        ],
        "meta": {
          "description": "The status of the recording"
        }
      },
      {
        "name": "media_url",
        "type": "string",
        "selector": [
          "media_url"
        ],
        "meta": {
          "description": "The URL of the media file associated with this recording"
        }
      }
    ],
    "operations": {
      "list": {
        "method": "GET",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "read": {
        "method": "GET",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "create": null,
      "update": null,
      "delete": {
        "method": "DELETE",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      }
    }
  },
  {
    "handle": "transcriptions",
    "meta": {
      "short": "Transcriptions",
      "description": "Manage transcriptions of recordings"
    },
    "endpoint": {
      "value": "/Transcriptions.json",
      "placeholders": []
    },
    "fields": [
      {
        "name": "sid",
        "type": "string",
        "selector": [
          "sid"
        ],
        "meta": {
          "description": "The unique string that identifies the resource"
        }
      },
      {
        "name": "recording_sid",
        "type": "string",
        "selector": [
          "recording_sid"
        ],
        "meta": {
          "description": "The SID of the Recording from which the transcription was created"
        }
      },
      {
        "name": "duration",
        "type": "string",
        "selector": [
          "duration"
        ],
        "meta": {
          "description": "The duration of the transcribed audio in seconds"
        }
      },
      {
        "name": "status",
        "type": "string",
        "selector": [
          "status"
        ],
        "meta": {
          "description": "The status of the transcription"
        }
      },
      {
        "name": "transcription_text",
        "type": "string",
        "selector": [
          "transcription_text"
        ],
        "meta": {
          "description": "The text content of the transcription"
        }
      }
    ],
    "operations": {
      "list": {
        "method": "GET",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "read": {
        "method": "GET",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "create": null,
      "update": null,
      "delete": {
        "method": "DELETE",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      }
    }
  },
  {
    "handle": "keys",
    "meta": {
      "short": "Keys",
      "description": "Manage API Keys"
    },
    "endpoint": {
      "value": "/Keys.json",
      "placeholders": []
    },
    "fields": [
      {
        "name": "sid",
        "type": "string",
        "selector": [
          "sid"
        ],
        "meta": {
          "description": "The unique string that identifies the resource"
        }
      },
      {
        "name": "friendly_name",
        "type": "string",
        "selector": [
          "friendly_name"
        ],
        "meta": {
          "description": "A descriptive string that identifies this resource"
        }
      },
      {
        "name": "date_created",
        "type": "string",
        "selector": [
          "date_created"
        ],
        "meta": {
          "description": "The date and time in GMT that the resource was created"
        }
      }
    ],
    "operations": {
      "list": {
        "method": "GET",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "read": {
        "method": "GET",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "create": {
        "method": "POST",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "update": {
        "method": "POST",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "delete": {
        "method": "DELETE",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      }
    }
  },
  {
    "handle": "available_phone_numbers",
    "meta": {
      "short": "Available Phone Numbers",
      "description": "Search for phone numbers available for purchase"
    },
    "endpoint": {
      "value": "/AvailablePhoneNumbers/{{country_code}}/Local.json",
      "placeholders": []
    },
    "fields": [
      {
        "name": "phone_number",
        "type": "string",
        "selector": [
          "phone_number"
        ],
        "meta": {
          "description": "An available phone number"
        }
      },
      {
        "name": "friendly_name",
        "type": "string",
        "selector": [
          "friendly_name"
        ],
        "meta": {
          "description": "A formatted version of the phone number"
        }
      },
      {
        "name": "region",
        "type": "string",
        "selector": [
          "region"
        ],
        "meta": {
          "description": "The region or state of the phone number"
        }
      },
      {
        "name": "postal_code",
        "type": "string",
        "selector": [
          "postal_code"
        ],
        "meta": {
          "description": "The postal code of the phone number"
        }
      },
      {
        "name": "iso_country",
        "type": "string",
        "selector": [
          "iso_country"
        ],
        "meta": {
          "description": "The ISO country code of the phone number"
        }
      }
    ],
    "operations": {
      "list": {
        "method": "GET",
        "path": {
          "value": "/AvailablePhoneNumbers/{{country_code}}/Local.json",
          "placeholders": [
            {
              "name": "country_code",
              "type": "String",
              "description": "The ISO-3166-1 country code",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "read": null,
      "create": null,
      "update": null,
      "delete": null
    }
  },
  {
    "handle": "conferences",
    "meta": {
      "short": "Conferences",
      "description": "Manage Voice Conferences"
    },
    "endpoint": {
      "value": "/Conferences.json",
      "placeholders": []
    },
    "fields": [
      {
        "name": "sid",
        "type": "string",
        "selector": [
          "sid"
        ],
        "meta": {
          "description": "The unique string that identifies the resource"
        }
      },
      {
        "name": "friendly_name",
        "type": "string",
        "selector": [
          "friendly_name"
        ],
        "meta": {
          "description": "A descriptive string that identifies this resource"
        }
      },
      {
        "name": "status",
        "type": "string",
        "selector": [
          "status"
        ],
        "meta": {
          "description": "The status of the conference"
        }
      },
      {
        "name": "region",
        "type": "string",
        "selector": [
          "region"
        ],
        "meta": {
          "description": "The region where the conference audio is hosted"
        }
      }
    ],
    "operations": {
      "list": {
        "method": "GET",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "read": {
        "method": "GET",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "create": null,
      "update": {
        "method": "POST",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "delete": null
    }
  },
  {
    "handle": "participants",
    "meta": {
      "short": "Conference Participants",
      "description": "Manage participants in a Voice Conference"
    },
    "endpoint": {
      "value": "/Conferences/{{conference_sid}}/Participants.json",
      "placeholders": []
    },
    "fields": [
      {
        "name": "sid",
        "type": "string",
        "selector": [
          "sid"
        ],
        "meta": {
          "description": "The unique string that identifies the participant"
        }
      },
      {
        "name": "conference_sid",
        "type": "string",
        "selector": [
          "conference_sid"
        ],
        "meta": {
          "description": "The SID of the participant's conference"
        }
      },
      {
        "name": "status",
        "type": "string",
        "selector": [
          "status"
        ],
        "meta": {
          "description": "The status of the participant"
        }
      },
      {
        "name": "muted",
        "type": "string",
        "selector": [
          "muted"
        ],
        "meta": {
          "description": "Whether the participant is muted"
        }
      }
    ],
    "operations": {
      "list": {
        "method": "GET",
        "path": {
          "value": "/Conferences/{{conference_sid}}/Participants.json",
          "placeholders": [
            {
              "name": "conference_sid",
              "type": "String",
              "description": "The SID of the conference",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "read": {
        "method": "GET",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "create": null,
      "update": {
        "method": "POST",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "delete": {
        "method": "DELETE",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      }
    }
  },
  {
    "handle": "queues",
    "meta": {
      "short": "Queues",
      "description": "Manage call queues"
    },
    "endpoint": {
      "value": "/Queues.json",
      "placeholders": []
    },
    "fields": [
      {
        "name": "sid",
        "type": "string",
        "selector": [
          "sid"
        ],
        "meta": {
          "description": "The unique string that identifies the resource"
        }
      },
      {
        "name": "friendly_name",
        "type": "string",
        "selector": [
          "friendly_name"
        ],
        "meta": {
          "description": "A descriptive string that identifies this resource"
        }
      },
      {
        "name": "current_size",
        "type": "string",
        "selector": [
          "current_size"
        ],
        "meta": {
          "description": "The number of calls currently in the queue"
        }
      },
      {
        "name": "max_size",
        "type": "string",
        "selector": [
          "max_size"
        ],
        "meta": {
          "description": "The maximum number of calls allowed in the queue"
        }
      }
    ],
    "operations": {
      "list": {
        "method": "GET",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "read": {
        "method": "GET",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "create": {
        "method": "POST",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "update": {
        "method": "POST",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "delete": {
        "method": "DELETE",
        "path": {
          "value": "/{{sid}}.json",
          "placeholders": [
            {
              "name": "sid",
              "type": "String",
              "description": "The unique SID identifier",
              "required": true
            }
          ]
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      }
    }
  },
  {
    "handle": "validation_requests",
    "meta": {
      "short": "Validation Requests",
      "description": "Request caller ID validation"
    },
    "endpoint": {
      "value": "/ValidationRequests.json",
      "placeholders": []
    },
    "fields": [
      {
        "name": "phone_number",
        "type": "string",
        "selector": [
          "phone_number"
        ],
        "meta": {
          "description": "The phone number that was verified"
        }
      },
      {
        "name": "friendly_name",
        "type": "string",
        "selector": [
          "friendly_name"
        ],
        "meta": {
          "description": "A descriptive string that identifies this expected validation"
        }
      },
      {
        "name": "validation_code",
        "type": "string",
        "selector": [
          "validation_code"
        ],
        "meta": {
          "description": "The 6 digit validation code that someone must enter"
        }
      }
    ],
    "operations": {
      "list": null,
      "read": null,
      "create": {
        "method": "POST",
        "path": {
          "value": "",
          "placeholders": []
        },
        "headers": {},
        "queryParams": {},
        "bodyTemplate": null
      },
      "update": null,
      "delete": null
    }
  }
]
```

<p align="center"><a class="button primary" data-icon="square-caret-right">Try @Human</a><a class="button primary" data-icon="check">Buy @Human Subscription</a><a class="button primary" data-icon="comments">Join @Human Community</a></p>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.planetcrust.com/human-connections/twilio/twilio.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.