--- title: FullStory API Integration on Truto slug: fullstory category: Analytics canonical: "https://truto.one/integrations/detail/fullstory/" --- # FullStory API Integration on Truto **Category:** Analytics **Status:** Generally available ## How it works 1. **Link your customer's FullStory 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 FullStory.** The Proxy API is a 1-to-1 mapping of the FullStory 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 - **Attach session replays to support tickets automatically** — Helpdesk and CRM SaaS companies can offer their customers a native FullStory integration that auto-links the exact session replay URL to every support ticket or conversation, giving agents instant visual context without asking the end user to reproduce the issue. - **Enrich error reports with visual stack traces** — Error monitoring and observability SaaS products can pull FullStory session URLs tied to specific exceptions, so developers see both the technical stack trace and a video of the user interaction that triggered the crash — eliminating the bug reproduction phase entirely. - **Sync CRM and billing attributes into FullStory for behavioral segmentation** — Data platforms and customer success tools can push user properties like subscription tier, account health score, or lifetime value into FullStory, enabling their customers to filter session replays by business-critical attributes rather than just technical ones. - **Trigger proactive in-app engagement from frustration signals** — User onboarding and in-app messaging SaaS products can react to FullStory's rage click and dead click signals to trigger contextual help modals or live chat prompts, turning user frustration into a proactive support moment. - **Correlate qualitative feedback with actual user behavior** — Survey and customer feedback SaaS companies can embed FullStory session replay links alongside NPS scores or CSAT responses, letting product teams watch exactly what happened before a user left negative feedback. ## What you can build - **Session Replay Sidebar Widget** — Display a clickable deep-linked FullStory session replay URL — timestamped to the moment of interest — directly inside your product's agent or analyst UI. - **Bidirectional User Property Sync** — Push custom user attributes like plan type, company size, or health score from your platform into FullStory so sessions can be filtered by business context. - **Server-Side Event Forwarding** — Send backend events such as payment failures, subscription changes, or feature flag flips into FullStory so product teams can correlate front-end behavior with back-end state. - **Frustration Signal Webhook Listener** — Consume FullStory rage click and error click events to trigger automated workflows like opening a support ticket, sending a Slack alert, or launching an in-app help flow. - **Behavioral Data Export Pipeline** — Use FullStory's Segment Export API to extract raw behavioral data and feed it into your customer's data warehouse for advanced analytics and ML models. - **Contextual Bug Report Enrichment** — Automatically append the FullStory session URL, browser info, OS, and console errors to bug reports or Jira tickets created from within your product. ## FAQs ### Is the FullStory integration available as a pre-built Unified API on Truto? FullStory is not yet available as a pre-built Unified API or tool on Truto. It is built on request — contact Truto to scope and prioritize the integration based on your specific use case. ### What authentication method does FullStory's API use? FullStory's V2 API uses API key-based authentication (Bearer token). Your end users would provide their FullStory API key, and Truto would handle storing and injecting it securely into every request. ### Can I both read and write data through the FullStory API? Yes. FullStory's V2 Server API supports creating and updating users (with custom properties), sending custom events, and exporting behavioral segments. The Browser API additionally supports generating deep-linked session replay URLs on the client side. ### Are there rate limits on the FullStory API? Yes. FullStory enforces rate limits on its V2 API endpoints. Exact limits vary by endpoint and plan tier. Truto can handle retry logic and backoff strategies so your application doesn't need to manage rate limit errors directly. ### What data can I extract from FullStory for my integration? Key data includes deep-linked session replay URLs (with exact timestamps), user identity and custom properties, custom events, frustration signals (rage clicks, dead clicks, error clicks), and bulk behavioral data via the Segment Export API on Enterprise plans. ### How does Truto handle pagination and async exports from FullStory? FullStory's Segment Export API is asynchronous — you request an export and poll for completion. Once built, Truto would abstract this into a simple sync operation, handling polling, pagination, and large file downloads behind a consistent interface.