@apteva/integrations 0.3.62 → 0.15.3

package/src/apps/twilio.json

@@ -1,7 +1,7 @@
 {
   "slug": "twilio",
   "name": "Twilio",
-  "description": "Twilio communications platform — SMS, MMS, voice calls, WhatsApp, phone numbers, recordings, usage, and verification",
+  "description": "Twilio communications platform \u2014 SMS, MMS, voice calls, WhatsApp, phone numbers, recordings, usage, and verification",
   "logo": "https://www.google.com/s2/favicons?domain=twilio.com&sz=128",
   "categories": [
     "messaging",
@@ -14,26 +14,25 @@
   "base_url": "https://api.twilio.com/2010-04-01",
   "auth": {
     "types": [
-      "bearer"
+      "basic"
     ],
     "headers": {
-      "Authorization": "Bearer {{token}}"
+      "Authorization": "Basic {{basic_auth}}",
+      "Content-Type": "application/x-www-form-urlencoded"
     },
     "credential_fields": [
       {
         "name": "account_sid",
-        "label": "Account_sid",
-        "description": "Your Twilio Account SID"
+        "label": "Account SID",
+        "description": "Your Twilio Account SID (used as the HTTP Basic username)",
+        "required": true
       },
       {
         "name": "auth_token",
-        "label": "Auth_token",
-        "description": "Your Twilio Auth Token"
-      },
-      {
-        "name": "phone_number",
-        "label": "Phone_number",
-        "description": "Your Twilio Phone Number"
+        "label": "Auth Token",
+        "description": "Your Twilio Auth Token (used as the HTTP Basic password)",
+        "required": true,
+        "type": "password"
       }
     ]
   },
@@ -42,7 +41,7 @@
       "name": "send_sms",
       "description": "Send an SMS or MMS message via Twilio. Supports text, media attachments, content templates, and status callbacks.",
       "method": "POST",
-      "path": "/Accounts/{{credential.account_sid}}/Messages.json",
+      "path": "/Accounts/{{account_sid}}/Messages.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -79,13 +78,28 @@
           "To",
           "From"
         ]
+      },
+      "mock_response": {
+        "sid": "SM00000000000000000000000000000001",
+        "account_sid": "AC00000000000000000000000000000000",
+        "from": "+15005550006",
+        "to": "+15558675310",
+        "body": "(message body)",
+        "status": "queued",
+        "direction": "outbound-api",
+        "num_segments": "1",
+        "price": null,
+        "price_unit": "USD",
+        "error_code": null,
+        "date_created": "Fri, 22 May 2026 12:00:00 +0000",
+        "uri": "/2010-04-01/Accounts/AC00000000000000000000000000000000/Messages/SM00000000000000000000000000000001.json"
       }
     },
     {
       "name": "send_whatsapp",
       "description": "Send a WhatsApp message via Twilio. Use whatsapp: prefix on phone numbers. For business-initiated conversations (user hasn't messaged you in 24h), you MUST use a ContentSid (approved template) instead of Body. Free-form Body only works within the 24-hour window after the user messages you.",
       "method": "POST",
-      "path": "/Accounts/{{credential.account_sid}}/Messages.json",
+      "path": "/Accounts/{{account_sid}}/Messages.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -112,12 +126,29 @@
           "MediaUrl": {
             "type": "string",
             "description": "URL of media to include"
+          },
+          "StatusCallback": {
+            "type": "string",
+            "description": "URL for delivery status webhooks"
           }
         },
         "required": [
           "To",
           "From"
         ]
+      },
+      "mock_response": {
+        "sid": "SM00000000000000000000000000000002",
+        "account_sid": "AC00000000000000000000000000000000",
+        "from": "whatsapp:+14155238886",
+        "to": "whatsapp:+15558675310",
+        "body": "(message body)",
+        "status": "queued",
+        "direction": "outbound-api",
+        "num_segments": "1",
+        "price": null,
+        "error_code": null,
+        "date_created": "Fri, 22 May 2026 12:00:00 +0000"
       }
     },
     {
@@ -138,7 +169,7 @@
               "whatsapp"
             ],
             "default": "whatsapp",
-            "description": "Channel type — must be 'whatsapp'"
+            "description": "Channel type \u2014 must be 'whatsapp'"
           }
         },
         "required": [
@@ -151,7 +182,7 @@
       "name": "get_message",
       "description": "Retrieve details of a specific message by SID.",
       "method": "GET",
-      "path": "/Accounts/{{credential.account_sid}}/Messages/{MessageSid}.json",
+      "path": "/Accounts/{{account_sid}}/Messages/{MessageSid}.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -163,13 +194,27 @@
         "required": [
           "MessageSid"
         ]
+      },
+      "mock_response": {
+        "sid": "SM00000000000000000000000000000001",
+        "account_sid": "AC00000000000000000000000000000000",
+        "from": "+15005550006",
+        "to": "+15558675310",
+        "body": "Your code is 123456",
+        "status": "delivered",
+        "direction": "outbound-api",
+        "num_segments": "1",
+        "price": "-0.00790",
+        "price_unit": "USD",
+        "error_code": null,
+        "date_sent": "Fri, 22 May 2026 12:00:02 +0000"
       }
     },
     {
       "name": "list_messages",
       "description": "List sent and received messages with optional filters.",
       "method": "GET",
-      "path": "/Accounts/{{credential.account_sid}}/Messages.json",
+      "path": "/Accounts/{{account_sid}}/Messages.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -191,13 +236,29 @@
             "description": "Number of messages to return (max 1000)"
           }
         }
+      },
+      "mock_response": {
+        "messages": [
+          {
+            "sid": "SM00000000000000000000000000000001",
+            "from": "+15005550006",
+            "to": "+15558675310",
+            "body": "Your code is 123456",
+            "status": "delivered",
+            "direction": "outbound-api",
+            "num_segments": "1"
+          }
+        ],
+        "page": 0,
+        "page_size": 50,
+        "uri": "/2010-04-01/Accounts/AC00000000000000000000000000000000/Messages.json"
       }
     },
     {
       "name": "delete_message",
       "description": "Delete a message by SID. This removes the message body and media but keeps the log entry.",
       "method": "DELETE",
-      "path": "/Accounts/{{credential.account_sid}}/Messages/{MessageSid}.json",
+      "path": "/Accounts/{{account_sid}}/Messages/{MessageSid}.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -215,7 +276,7 @@
       "name": "make_call",
       "description": "Initiate an outbound phone call. Provide either a TwiML URL or inline TwiML instructions.",
       "method": "POST",
-      "path": "/Accounts/{{credential.account_sid}}/Calls.json",
+      "path": "/Accounts/{{account_sid}}/Calls.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -261,13 +322,23 @@
           "To",
           "From"
         ]
+      },
+      "mock_response": {
+        "sid": "CA00000000000000000000000000000001",
+        "account_sid": "AC00000000000000000000000000000000",
+        "from": "+15005550006",
+        "to": "+15558675310",
+        "status": "queued",
+        "direction": "outbound-api",
+        "date_created": "Fri, 22 May 2026 12:00:00 +0000",
+        "uri": "/2010-04-01/Accounts/AC00000000000000000000000000000000/Calls/CA00000000000000000000000000000001.json"
       }
     },
     {
       "name": "get_call",
       "description": "Retrieve details of a specific call by SID.",
       "method": "GET",
-      "path": "/Accounts/{{credential.account_sid}}/Calls/{CallSid}.json",
+      "path": "/Accounts/{{account_sid}}/Calls/{CallSid}.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -279,13 +350,26 @@
         "required": [
           "CallSid"
         ]
+      },
+      "mock_response": {
+        "sid": "CA00000000000000000000000000000001",
+        "account_sid": "AC00000000000000000000000000000000",
+        "from": "+15005550006",
+        "to": "+15558675310",
+        "status": "completed",
+        "duration": "42",
+        "direction": "outbound-api",
+        "price": "-0.01400",
+        "price_unit": "USD",
+        "start_time": "Fri, 22 May 2026 12:00:05 +0000",
+        "end_time": "Fri, 22 May 2026 12:00:47 +0000"
       }
     },
     {
       "name": "list_calls",
       "description": "List call logs with optional filters for status, date, and phone numbers.",
       "method": "GET",
-      "path": "/Accounts/{{credential.account_sid}}/Calls.json",
+      "path": "/Accounts/{{account_sid}}/Calls.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -325,9 +409,9 @@
     },
     {
       "name": "update_call",
-      "description": "Modify an in-progress call — redirect to new TwiML, end the call, or pause/resume recording.",
+      "description": "Modify an in-progress call \u2014 redirect to new TwiML, end the call, or pause/resume recording.",
       "method": "POST",
-      "path": "/Accounts/{{credential.account_sid}}/Calls/{CallSid}.json",
+      "path": "/Accounts/{{account_sid}}/Calls/{CallSid}.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -361,7 +445,7 @@
       "name": "list_phone_numbers",
       "description": "List all phone numbers in your Twilio account with their capabilities and configuration.",
       "method": "GET",
-      "path": "/Accounts/{{credential.account_sid}}/IncomingPhoneNumbers.json",
+      "path": "/Accounts/{{account_sid}}/IncomingPhoneNumbers.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -385,7 +469,7 @@
       "name": "buy_phone_number",
       "description": "Purchase a phone number for your Twilio account.",
       "method": "POST",
-      "path": "/Accounts/{{credential.account_sid}}/IncomingPhoneNumbers.json",
+      "path": "/Accounts/{{account_sid}}/IncomingPhoneNumbers.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -401,6 +485,28 @@
             "type": "string",
             "description": "Webhook URL for incoming SMS"
           },
+          "SmsMethod": {
+            "type": "string",
+            "enum": [
+              "GET",
+              "POST"
+            ],
+            "default": "POST",
+            "description": "HTTP method Twilio uses for incoming SMS webhooks"
+          },
+          "SmsFallbackUrl": {
+            "type": "string",
+            "description": "Fallback webhook URL if the incoming SMS webhook fails"
+          },
+          "SmsFallbackMethod": {
+            "type": "string",
+            "enum": [
+              "GET",
+              "POST"
+            ],
+            "default": "POST",
+            "description": "HTTP method Twilio uses for the incoming SMS fallback webhook"
+          },
           "VoiceUrl": {
             "type": "string",
             "description": "Webhook URL for incoming calls"
@@ -413,9 +519,9 @@
     },
     {
       "name": "update_phone_number",
-      "description": "Update configuration for a phone number — webhooks, friendly name, voice/SMS settings.",
+      "description": "Update configuration for a phone number \u2014 webhooks, friendly name, voice/SMS settings.",
       "method": "POST",
-      "path": "/Accounts/{{credential.account_sid}}/IncomingPhoneNumbers/{PhoneNumberSid}.json",
+      "path": "/Accounts/{{account_sid}}/IncomingPhoneNumbers/{PhoneNumberSid}.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -431,6 +537,28 @@
             "type": "string",
             "description": "Webhook URL for incoming SMS"
           },
+          "SmsMethod": {
+            "type": "string",
+            "enum": [
+              "GET",
+              "POST"
+            ],
+            "default": "POST",
+            "description": "HTTP method Twilio uses for incoming SMS webhooks"
+          },
+          "SmsFallbackUrl": {
+            "type": "string",
+            "description": "Fallback webhook URL if the incoming SMS webhook fails"
+          },
+          "SmsFallbackMethod": {
+            "type": "string",
+            "enum": [
+              "GET",
+              "POST"
+            ],
+            "default": "POST",
+            "description": "HTTP method Twilio uses for the incoming SMS fallback webhook"
+          },
           "VoiceUrl": {
             "type": "string",
             "description": "Webhook URL for incoming calls"
@@ -449,7 +577,7 @@
       "name": "release_phone_number",
       "description": "Release (delete) a phone number from your Twilio account.",
       "method": "DELETE",
-      "path": "/Accounts/{{credential.account_sid}}/IncomingPhoneNumbers/{PhoneNumberSid}.json",
+      "path": "/Accounts/{{account_sid}}/IncomingPhoneNumbers/{PhoneNumberSid}.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -467,7 +595,7 @@
       "name": "search_available_numbers",
       "description": "Search for available phone numbers to purchase by country, area code, or capabilities.",
       "method": "GET",
-      "path": "/Accounts/{{credential.account_sid}}/AvailablePhoneNumbers/{Country}/Local.json",
+      "path": "/Accounts/{{account_sid}}/AvailablePhoneNumbers/{Country}/Local.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -507,13 +635,30 @@
         "required": [
           "Country"
         ]
+      },
+      "mock_response": {
+        "available_phone_numbers": [
+          {
+            "friendly_name": "(415) 555-0100",
+            "phone_number": "+14155550100",
+            "locality": "San Francisco",
+            "region": "CA",
+            "iso_country": "US",
+            "capabilities": {
+              "voice": true,
+              "SMS": true,
+              "MMS": true
+            }
+          }
+        ],
+        "uri": "/2010-04-01/Accounts/AC00000000000000000000000000000000/AvailablePhoneNumbers/US/Local.json"
       }
     },
     {
       "name": "search_toll_free_numbers",
       "description": "Search for available toll-free phone numbers to purchase.",
       "method": "GET",
-      "path": "/Accounts/{{credential.account_sid}}/AvailablePhoneNumbers/{Country}/TollFree.json",
+      "path": "/Accounts/{{account_sid}}/AvailablePhoneNumbers/{Country}/TollFree.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -551,7 +696,7 @@
       "name": "list_recordings",
       "description": "List call recordings with optional filters.",
       "method": "GET",
-      "path": "/Accounts/{{credential.account_sid}}/Recordings.json",
+      "path": "/Accounts/{{account_sid}}/Recordings.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -575,7 +720,7 @@
       "name": "get_recording",
       "description": "Retrieve details of a specific recording.",
       "method": "GET",
-      "path": "/Accounts/{{credential.account_sid}}/Recordings/{RecordingSid}.json",
+      "path": "/Accounts/{{account_sid}}/Recordings/{RecordingSid}.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -593,7 +738,7 @@
       "name": "delete_recording",
       "description": "Delete a call recording.",
       "method": "DELETE",
-      "path": "/Accounts/{{credential.account_sid}}/Recordings/{RecordingSid}.json",
+      "path": "/Accounts/{{account_sid}}/Recordings/{RecordingSid}.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -611,27 +756,39 @@
       "name": "get_account",
       "description": "Retrieve your Twilio account details including balance, status, and type.",
       "method": "GET",
-      "path": "/Accounts/{{credential.account_sid}}.json",
+      "path": "/Accounts/{{account_sid}}.json",
       "input_schema": {
         "type": "object",
         "properties": {}
+      },
+      "mock_response": {
+        "sid": "AC00000000000000000000000000000000",
+        "friendly_name": "Apteva",
+        "status": "active",
+        "type": "Full",
+        "date_created": "Mon, 01 Jan 2024 00:00:00 +0000"
       }
     },
     {
       "name": "get_balance",
       "description": "Retrieve your Twilio account balance and currency.",
       "method": "GET",
-      "path": "/Accounts/{{credential.account_sid}}/Balance.json",
+      "path": "/Accounts/{{account_sid}}/Balance.json",
       "input_schema": {
         "type": "object",
         "properties": {}
+      },
+      "mock_response": {
+        "account_sid": "AC00000000000000000000000000000000",
+        "balance": "42.35000",
+        "currency": "USD"
       }
     },
     {
       "name": "get_usage",
-      "description": "Retrieve usage records for your account — see costs per category (calls, SMS, numbers, etc.).",
+      "description": "Retrieve usage records for your account \u2014 see costs per category (calls, SMS, numbers, etc.).",
       "method": "GET",
-      "path": "/Accounts/{{credential.account_sid}}/Usage/Records.json",
+      "path": "/Accounts/{{account_sid}}/Usage/Records.json",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -659,7 +816,8 @@
       "name": "list_whatsapp_senders",
       "description": "List all WhatsApp Business senders (phone numbers) registered in your Twilio account. Shows sender status, phone number, and WhatsApp Business profile details.",
       "method": "GET",
-      "path": "/v2/Channels/Senders",
+      "base_url": "https://messaging.twilio.com",
+      "path": "/v2/Channels/Senders?Channel=whatsapp",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -673,8 +831,9 @@
     },
     {
       "name": "get_whatsapp_sender",
-      "description": "Get details of a specific WhatsApp Business sender by SID — status, phone number, profile info, and capabilities.",
+      "description": "Get details of a specific WhatsApp Business sender by SID \u2014 status, phone number, profile info, and capabilities.",
       "method": "GET",
+      "base_url": "https://messaging.twilio.com",
       "path": "/v2/Channels/Senders/{SenderSid}",
       "input_schema": {
         "type": "object",
@@ -693,6 +852,10 @@
       "name": "register_whatsapp_sender",
       "description": "Register a phone number as a WhatsApp Business sender. For SMS-capable Twilio numbers, verification is automatic. For voice-only or non-Twilio numbers, OTP verification is required separately.",
       "method": "POST",
+      "base_url": "https://messaging.twilio.com",
+      "headers": {
+        "Content-Type": "application/json"
+      },
       "path": "/v2/Channels/Senders",
       "input_schema": {
         "type": "object",
@@ -774,11 +937,76 @@
         ]
       }
     },
+    {
+      "name": "update_whatsapp_sender",
+      "description": "Update a WhatsApp Business sender's webhook/profile/configuration. Messaging uses this to point inbound WhatsApp messages at its Twilio inbound webhook.",
+      "method": "POST",
+      "base_url": "https://messaging.twilio.com",
+      "headers": {
+        "Content-Type": "application/json"
+      },
+      "path": "/v2/Channels/Senders/{SenderSid}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "SenderSid": {
+            "type": "string",
+            "description": "WhatsApp Sender SID (XE...)"
+          },
+          "webhook": {
+            "type": "object",
+            "description": "Webhook settings. Example: {\"callback_url\":\"https://.../twilio-inbound\",\"callback_method\":\"POST\"}",
+            "properties": {
+              "callback_url": {
+                "type": "string",
+                "description": "URL Twilio calls for inbound WhatsApp messages"
+              },
+              "callback_method": {
+                "type": "string",
+                "enum": [
+                  "POST",
+                  "PUT"
+                ],
+                "default": "POST"
+              },
+              "fallback_url": {
+                "type": "string"
+              },
+              "fallback_method": {
+                "type": "string",
+                "enum": [
+                  "POST",
+                  "PUT"
+                ]
+              },
+              "status_callback_url": {
+                "type": "string"
+              },
+              "status_callback_method": {
+                "type": "string"
+              }
+            }
+          },
+          "profile": {
+            "type": "object",
+            "description": "Optional WhatsApp profile fields to update"
+          },
+          "configuration": {
+            "type": "object",
+            "description": "Optional sender configuration fields such as verification_code"
+          }
+        },
+        "required": [
+          "SenderSid"
+        ]
+      }
+    },
     {
       "name": "list_content_templates",
       "description": "List WhatsApp content templates with their approval status. Use this to see all message templates, their types, and whether they're approved for WhatsApp.",
       "method": "GET",
-      "path": "/v2/ContentAndApprovals",
+      "base_url": "https://content.twilio.com",
+      "path": "/v1/ContentAndApprovals",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -800,8 +1028,9 @@
     },
     {
       "name": "get_content_template",
-      "description": "Retrieve details of a specific content template by SID — body, variables, type, and approval status.",
+      "description": "Retrieve details of a specific content template by SID \u2014 body, variables, type, and approval status.",
       "method": "GET",
+      "base_url": "https://content.twilio.com",
       "path": "/v1/Content/{ContentSid}",
       "input_schema": {
         "type": "object",
@@ -820,6 +1049,10 @@
       "name": "create_content_template",
       "description": "Create a new content template for WhatsApp messaging. Templates must be submitted for approval before use. Supports text, media, quick reply, call-to-action, and card types.",
       "method": "POST",
+      "base_url": "https://content.twilio.com",
+      "headers": {
+        "Content-Type": "application/json"
+      },
       "path": "/v1/Content",
       "input_schema": {
         "type": "object",
@@ -853,6 +1086,10 @@
       "name": "submit_content_template_approval",
       "description": "Submit a content template for WhatsApp approval. Once approved by Meta, the template can be used to initiate conversations outside the 24-hour window.",
       "method": "POST",
+      "base_url": "https://content.twilio.com",
+      "headers": {
+        "Content-Type": "application/json"
+      },
       "path": "/v1/Content/{ContentSid}/ApprovalRequests/whatsapp",
       "input_schema": {
         "type": "object",
@@ -886,6 +1123,10 @@
       "name": "delete_content_template",
       "description": "Delete a content template. Cannot delete templates that have been submitted for WhatsApp approval.",
       "method": "DELETE",
+      "base_url": "https://content.twilio.com",
+      "headers": {
+        "Content-Type": "application/json"
+      },
       "path": "/v1/Content/{ContentSid}",
       "input_schema": {
         "type": "object",
@@ -902,7 +1143,7 @@
     },
     {
       "name": "lookup_phone_number",
-      "description": "Look up information about a phone number — carrier, caller name, line type (mobile/landline/voip).",
+      "description": "Look up information about a phone number \u2014 carrier, caller name, line type (mobile/landline/voip).",
       "method": "GET",
       "path": "/v2/PhoneNumbers/{PhoneNumber}",
       "input_schema": {
@@ -921,6 +1162,13 @@
         "required": [
           "PhoneNumber"
         ]
+      },
+      "mock_response": {
+        "phone_number": "+15558675310",
+        "country_code": "US",
+        "national_format": "(555) 867-5310",
+        "calling_country_code": "1",
+        "valid": true
       }
     },
     {
@@ -979,6 +1227,16 @@
           "To",
           "Channel"
         ]
+      },
+      "mock_response": {
+        "sid": "VE00000000000000000000000000000001",
+        "service_sid": "VA00000000000000000000000000000000",
+        "account_sid": "AC00000000000000000000000000000000",
+        "to": "+15558675310",
+        "channel": "sms",
+        "status": "pending",
+        "valid": false,
+        "date_created": "2026-05-22T12:00:00Z"
       }
     },
     {
@@ -1007,6 +1265,16 @@
           "To",
           "Code"
         ]
+      },
+      "mock_response": {
+        "sid": "VE00000000000000000000000000000001",
+        "service_sid": "VA00000000000000000000000000000000",
+        "account_sid": "AC00000000000000000000000000000000",
+        "to": "+15558675310",
+        "channel": "sms",
+        "status": "approved",
+        "valid": true,
+        "date_created": "2026-05-22T12:00:00Z"
       }
     }
   ],
@@ -1058,5 +1326,8 @@
         "description": "Call recording ready"
       }
     ]
+  },
+  "health_check": {
+    "tool": "get_account"
   }
 }