Twilio TRIGGER
New Incoming SMS (Instant)
- Trigger
- Instant
- API key
- Webhook delivery
IMPLEMENTATION
Deploy this event source
Connect the user's Twilio account, configure the source, and choose the webhook where your backend receives events.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const deployed = await pd.triggers.deploy({
id: "twilio-new-incoming-sms",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
twilio: { authProvisionId: "apn_xxxxxxx" },
incomingPhoneNumber: "Incoming Phone Number",
responseMessage: "Response Message",
},
webhookUrl: "https://example.com/webhooks/twilio",
})
console.log(deployed.id)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/triggers/deploy \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "twilio-new-incoming-sms",
"webhook_url": "https://example.com/webhooks/twilio",
"configured_props": {
"twilio": { "authProvisionId": "apn_xxxxxxx" },
"incomingPhoneNumber": "Incoming Phone Number",
"responseMessage": "Response Message"
}
}'MCP servers expose Twilio actions as on-demand tools.
New Incoming SMS (Instant) is an event source, so your application deploys it
with the Connect SDK or API and then either receives each event at a
webhook URL or retrieves events on demand with the trigger events API.MCP exposes on-demand actions. Event sources are deployed through the Connect SDK or API because they continue listening after the initial request.
SCHEMA
Configuration
These inputs define which events the source watches. Dynamic options are loaded from the connected account.
| Property | Type | Description |
|---|---|---|
incomingPhoneNumber Incoming Phone Number | string | The Twilio phone number where you'll receive messages. This source creates a webhook tied to this incoming phone number, overwriting any existing webhook URL. Required Dynamic |
responseMessage Response Message | string | The message you want to send in response to incoming messages. Leave this blank if you don't need to issue a response. Optional |
LIFECYCLE
Event delivery
01
Connect
Your user authorizes Twilio through Pipedream managed auth.
02
Deploy
Your backend deploys this source with that user's own configuration.
03
Webhook delivery
Every event is sent to the HTTP endpoint you choose when you deploy the source — as it happens.
OR
On-demand retrieval
No webhook required. Your app or agent can fetch recent events from the trigger events API.
REFERENCE
Trigger details
- Registry key
- twilio-new-incoming-sms
- Version
- 0.1.6
- App
- Twilio
- Authentication
- API key
- Delivery
- Instant event
- Output
- Events emitted by Twilio.
- Source
- View on GitHub ↗