native-typeform_skill

Overview

This skill reads Typeform forms and responses directly from the Typeform API to help you inspect surveys, collect answers, and review performance metrics. It authenticates with a personal API token and makes direct calls to api.typeform.com without third-party proxies. Use it to list forms, pull form definitions, fetch responses with filters, and retrieve insights like views and completion rate.

How this skill works

The skill uses a Typeform personal access token with read scopes to call the official Typeform REST endpoints. It implements commands to list forms, search by title, fetch form definitions (questions, fields, logic), retrieve responses with optional date and limit filters, and request insights for a given form. Requests respect Typeform rate limits and return JSON data you can archive or process further.

When to use it

• You need to archive or back up all your Typeform forms and responses.
• You want to inspect form structure, questions, and logic programmatically.
• You need recent or filtered response exports for analysis or ETL.
• You want quick performance metrics (views, completions, completion rate) for a form.
• You prefer direct API access without third-party proxies.

Best practices

• Create a dedicated Typeform personal access token with only the read scopes required.
• Store the TYPEFORM_TOKEN securely in environment variables, not in source code.
• Respect the API rate limit (approx. 2 requests/second) and paginate large result sets.
• Use date filters and limits when pulling responses to avoid large, costly exports.
• Validate form IDs from list-forms output or the Typeform dashboard URL before requesting details.

Example use cases

• List all active forms and export definitions for an archival snapshot.
• Fetch the last 100 responses for a survey to feed into a BI dashboard.
• Filter responses by date range to build monthly performance reports.
• Retrieve insights for a form to monitor completion rates after an email campaign.
• Automate periodic backups of form schemas and answers for compliance or migration.