Typeform

This connector uses the Typeform Create/Responses API.

Setup:

1. Sign in to Typeform → top-right avatar → Settings → Personal tokens → Generate a new token.
2. Grant the scopes you need — at minimum forms:read, responses:read, workspaces:read. For write operations add forms:write. The connector's instructions documents what scopes each tool requires implicitly.
3. Copy the token (shown ONCE). Set TYPEFORM_PERSONAL_TOKEN.

Authentication: Bearer token. Same token for all endpoints.

Form IDs: each form has an 8-character alphanumeric ID (e.g. Wf2hrM), visible at the end of the form's public URL (yourname.typeform.com/to/Wf2hrM → ID is Wf2hrM). Use typeform_list_forms once to discover IDs you own.

Responses model: Typeform stores each submission as a 'response' with landed_at, submitted_at, answers[]. Each answer is keyed by the field's id (UUID) AND by a type (text/email/multiple_choice/number/...) — so reading answers requires knowing the form's fields. Cross-reference with typeform_get_form to map field IDs to user-readable titles.

Pagination for responses: typeform_list_responses accepts since/until timestamps or before/after token cursors. Default page_size 25, max 1000. For large exports, prefer date-range pagination over token cursors.

Incremental sync pattern: store the highest submitted_at you've processed and use it as since on the next call. Typeform sorts responses newest-first by default — set sort=submitted_at,asc to walk forward.

Webhooks out of scope (Typeform pushes on submission to a URL you host).

Hidden fields: the hidden object on a response captures URL parameters passed to the form (e.g. ?utm_source=newsletter). Read them via responses[].hidden.

Forms with logic / outcomes: scoring branches, calculator outputs, and ranking results appear in responses[].calculated and responses[].metadata. Score-based quizzes typically use calculated.score.

Rate limits: 2 requests/sec per token (Typeform default), 10000/day. On 429, back off — Retry-After header tells you how long.

Out of scope here: creating/editing form structure (use the Typeform UI; the API for forms:write exists but the JSON tree is dense and rarely worth automating), images/themes upload, custom workspaces beyond list.