View as Markdown
Twilio icon

Twilio TRIGGER

New Incoming SMS (Instant)

Emit new event every time an SMS is sent to the phone number set. Configures a webhook in Twilio, tied to an incoming phone number.
  • 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)

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.

New Incoming SMS (Instant) configuration
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

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.

Registry key
twilio-new-incoming-sms
Version
0.1.6
App
Twilio
Authentication
API key
Delivery
Instant event
Output
Events emitted by Twilio.