chatformdocs
API referenceV1

Convert a public Typeform, Google Form or Tally form into a form document

Reads the form behind a public link and converts its questions, options, required fields, endings and jumps. Returns the document **without saving it**, plus a report of anything that could not be copied (payments, scores, rules that test a different question). Post the document to `POST /v1/forms` to keep it. The source form must open without signing in.

POST
/v1/import

Authorization

AuthorizationBearer <token>

A server-side secret key. Never send one from a browser — a request carrying an Origin header is refused for this reason.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/v1/import" \  -H "Content-Type: application/json" \  -d '{    "url": "string"  }'
{  "doc": null,  "report": {    "provider": "typeform",    "sourceUrl": "string",    "questions": 0,    "branches": 0,    "endings": 0,    "notCopied": [      "string"    ],    "closed": true,    "outline": [      {        "title": "string",        "type": "string",        "required": true      }    ]  },  "property1": null,  "property2": null}