--- title: SurveySparrow API Integration on Truto slug: surveysparrow category: Survey canonical: "https://truto.one/integrations/detail/surveysparrow/" --- # SurveySparrow API Integration on Truto **Category:** Survey **Status:** Generally available ## Unified APIs ### Unified Forms API - **Collections** — - **Contacts** — - **Fields** — - **Forms** — - **Responses** — - **Users** — ### Unified User Directory API - **Groups** — Groups are a collection of users in the source application. In some applications, they might also be called Teams. - **Roles** — The Role object represents a role of a User. - **Users** — The User object represents a User. ## How it works 1. **Link your customer's SurveySparrow account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach SurveySparrow.** The Proxy API is a 1-to-1 mapping of the SurveySparrow API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Enrich CRM contacts with real-time survey sentiment** — CRM platforms can pull NPS and CSAT responses from SurveySparrow back into customer profiles, enabling sales and success teams to segment accounts by satisfaction score and trigger retention workflows for detractors. - **Automate post-event survey triggers from your app** — SaaS products can dispatch SurveySparrow surveys automatically when key milestones occur — ticket resolved, order delivered, onboarding completed — without their users needing to leave your platform or manually configure survey sends. - **Sync employee directories for continuous HR feedback loops** — HR and people ops platforms can sync their workforce data into SurveySparrow contact lists, automating 30-60-90 day check-ins, pulse surveys, and eNPS campaigns as employees are hired, promoted, or change teams. - **Build agent-level CSAT dashboards in support tools** — Helpdesk and support platforms can ingest SurveySparrow response data tied to custom variables like ticket ID and agent ID, attaching individual CSAT scores directly to agent performance views. - **Power product feedback workflows with structured survey data** — Product management tools can read survey form structures and responses from SurveySparrow to automatically categorize feature requests, validate hypotheses, and feed user sentiment into prioritization frameworks. ## What you can build - **Bi-directional contact sync with SurveySparrow** — Keep your app's contact database continuously synced with SurveySparrow contact lists so surveys always target the right, up-to-date audience segments. - **Survey response write-back to customer profiles** — Automatically pull completed NPS, CSAT, and custom survey responses into your app's user or account records for real-time sentiment enrichment. - **Automated survey dispatch on workflow events** — Trigger SurveySparrow survey sends when events fire in your product — ticket closure, onboarding completion, subscription renewal — with custom variables passed through for attribution. - **Team and role-aware survey visibility management** — Sync your app's team structures and permission models into SurveySparrow so survey access and ownership automatically reflects organizational hierarchy. - **Detractor alert and escalation engine** — Parse incoming survey responses for low scores and instantly surface churn-risk alerts, open follow-up tasks, or notify account owners inside your product. - **Embedded survey form browser** — Let your users browse, search, and select from their SurveySparrow surveys and form fields directly inside your app's UI without switching tools. ## FAQs ### What authentication method does SurveySparrow use? SurveySparrow's API supports OAuth 2.0 and API token-based authentication. Truto handles the OAuth flow and token refresh so your end users can connect their SurveySparrow workspace securely without you managing credentials. ### Which Unified APIs does the SurveySparrow integration support? SurveySparrow maps to Truto's Unified Forms API (Collections, Contacts, Fields, Forms, Responses, Users) and Unified User Directory API (Groups, Roles, Users). Specific tools are built on request based on your use case. ### Can I access custom fields and hidden variables from SurveySparrow surveys? Yes. SurveySparrow's API exposes question structures and custom variables, which map to the Fields resource in the Unified Forms API. This lets you read custom metadata like ticket IDs or agent IDs attached to survey responses. ### Does SurveySparrow support real-time data via webhooks? SurveySparrow provides webhook support for events like response completion. This enables reactive workflows — such as instant detractor alerts or profile enrichment — without polling the API. ### Are there rate limits on the SurveySparrow API? Yes, SurveySparrow enforces rate limits that vary by plan tier. Truto manages pagination and request throttling automatically so your integration stays within limits without manual retry logic. ### What if I need a specific SurveySparrow endpoint that isn't covered yet? SurveySparrow tools on Truto are built on request. If your use case requires endpoints beyond what the current Unified API resources cover — such as the Shares/Channels API for generating unique survey links — Truto can build and ship those tools for you.