Automate Surveys and Forms with the Typeform Skill: Create, Manage, and Analyze Forms from Your AI Agent

Ever wished your AI agent could create surveys on the fly, collect feedback automatically, or analyze form responses without you lifting a finger? The Typeform skill makes this possible by connecting Clawdbot directly to the Typeform API through managed OAuth—no complex authentication setup required.

Who Needs This?

If you're building workflows that involve:

• Customer feedback collection — automatically create post-purchase surveys
• Lead qualification forms — programmatically generate intake forms for sales
• Event registrations — spin up signup forms on demand
• Research surveys — create and analyze questionnaires at scale
• Internal tools — build dynamic forms for team workflows

Then this skill is for you. It eliminates the back-and-forth between your AI agent and Typeform's web interface.

Installation

Getting started takes just one command:

```bash npx clawhub@latest install typeform ```

The skill requires a Maton API key for OAuth authentication. Get yours at maton.ai/settings.

Configuration

Set your environment variable:

```bash export MATON_API_KEY="your_api_key_here" ```

Then connect your Typeform account. The skill uses Maton's OAuth gateway, so you'll need to create a connection once:

```python python <<'EOF' import urllib.request, os, json data = json.dumps({'app': 'typeform'}).encode() req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ```

This returns a URL—open it in your browser to authorize Typeform, and you're set.

Usage Examples

1. Create a Customer Feedback Survey

Ask your agent: "Create a quick feedback form asking for name, email, and satisfaction rating"

Behind the scenes, the skill hits:

```bash POST https://gateway.maton.ai/typeform/forms Content-Type: application/json

{ "title": "Customer Feedback", "fields": [ {"type": "short_text", "title": "What is your name?"}, {"type": "email", "title": "What is your email?"}, {"type": "rating", "title": "How satisfied are you with our service?"} ] } ```

2. Analyze Form Responses

Get all completed responses for a form:

```bash GET https://gateway.maton.ai/typeform/forms/{formId}/responses?completed=true&page_size=50 ```

Filter by date range:

```bash GET https://gateway.maton.ai/typeform/forms/{formId}/responses?since=2026-01-01T00:00:00Z&until=2026-02-18T23:59:59Z ```

3. Quick Response Summary

Pull insights for aggregate stats:

```bash GET https://gateway.maton.ai/typeform/insights/{formId}/summary ```

This gives you completion rates, average scores, and field-by-field breakdowns without parsing individual responses.

Available Field Types

When creating forms programmatically, you have 10 field types at your disposal:

• `short_text` — Single line input
• `long_text` — Multi-line paragraphs
• `email` — Email validation built-in
• `number` — Numeric input
• `rating` — Star ratings
• `opinion_scale` — 0-10 NPS-style scale
• `multiple_choice` — Single or multi-select options
• `yes_no` — Boolean questions
• `date` — Date picker
• `dropdown` — Selection menus

Pro Tips

1. Use `curl -g` for bracket URLs — When testing endpoints with `fields[]` or `sort[]` parameters, the `-g` flag prevents shell glob expansion issues.

2. Multiple accounts? Add the `Maton-Connection` header to specify which Typeform account to use: ``` Maton-Connection: your-connection-id ```

3. Watch the rate limit — Maton enforces 10 requests/second per account. Batch your operations when processing many forms.

4. Pagination token — For response lists, use the `before` token from each response to paginate through large datasets.

Error Handling

If you hit a 400, run the connection creation step above to re-authorize.

Conclusion

The Typeform skill transforms your AI agent into a form automation powerhouse. Create surveys conversationally, pull response data for analysis, and manage forms without context-switching to a web UI. Combined with Clawdbot's scheduling and automation capabilities, you can build fully autonomous feedback loops—from form creation to response analysis to follow-up actions.

Links:

• Typeform skill on ClawHub
• Typeform API docs
• Maton gateway