View as Markdown
Signal icon

Signal TRIGGER

New Message Received

Emit new event for each Signal message received on the configured phone number. See the documentation.
  • Trigger
  • Polling
  • API key
  • Webhook delivery

IMPLEMENTATION

Deploy this event source

Connect the user's Signal 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: "signal-new-message-received",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    signal: { authProvisionId: "apn_xxxxxxx" },
    timer: { "intervalSeconds": 900 },
    phoneNumber: "Phone Number",
  },
  webhookUrl: "https://example.com/webhooks/signal",
})

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 Message Received configuration
Property Type Description
timer Polling Schedule $.interface.timer
How often to poll for new messages
Required
phoneNumber Phone Number string
Your registered Signal phone number (e.g. +14151234567).
Required
timeout Receive Timeout integer
Timeout in seconds when receiving messages from the Signal network.
Optional
ignoreAttachments Ignore Attachments boolean
If enabled, attachments will not be downloaded when receiving messages.
Optional
ignoreStories Ignore Stories boolean
If enabled, story messages will be ignored when receiving messages.
Optional
sendReadReceipts Send Read Receipts boolean
If enabled, read receipts will automatically be sent for received messages.
Optional

01

Connect

Your user authorizes Signal 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 — after each poll.

OR

On-demand retrieval

No webhook required. Your app or agent can fetch recent events from the trigger events API.

Registry key
signal-new-message-received
Version
0.0.1
App
Signal
Authentication
API key
Delivery
Polling source
Output
Events emitted by Signal.