SurveySparrow icon

SurveySparrow

Create and share survey forms via Email, SMS, and WhatsApp; manage contacts

Actions2

Channel → Send Survey

AI-generated

Summary

Sends a SurveySparrow survey to a single contact via an existing Email, SMS, or WhatsApp share channel, by issuing a PUT to /v3/channels/{channelId} with the contact and optional survey variables.

Inputs

  • Channel Type (required) — Email, SMS, or WhatsApp. Determines which share-channel and contact fields are shown and used.
  • Survey Name or ID (required) — Survey to send; loaded from the account's surveys or set via expression.
  • Share Channel Name or ID (required) — Pre-configured share channel of the selected type for that survey (separate field for email, SMS, WhatsApp). Options load based on the chosen survey.
  • Contact Email (required) — Recipient email address. Shown only for Email channel type.
  • Contact Mobile (required) — Recipient mobile number in E.164 format (e.g. +15551234567). Shown for SMS and WhatsApp.
  • Variables — Zero or more name/value pairs for variables defined on the survey. Entries with no name are skipped; a named variable with an empty value throws an error. Sent only if at least one variable is set.

Output shape

One output item per input item, containing the JSON response returned by the SurveySparrow API for the channel share request.

Each item is paired to its input item. With Continue On Fail enabled, failed items return {error: message} instead of stopping the workflow. The exact response fields are not defined in the node code.

Examples

Example 1: Email a feedback survey to a new customer after an order is placed

Channel Type: Email; pick Survey and its Email share; Contact Email: {{ $json.email }}; optionally add variable order_id = {{ $json.orderId }}.

Example 2: Send an NPS survey over WhatsApp to a phone number from a CRM trigger

Channel Type: WhatsApp; pick Survey and WhatsApp share; Contact Mobile: {{ $json.phone }} (E.164).

Links

Discussion