---
title: "Attach an external questionnaire"
method: POST
path: "/api/v1/questionnaires/create_external"
tags: ["Questionnaires"]
---

# Attach an external questionnaire

`POST /api/v1/questionnaires/create_external`

## Request

- Base URL: `https://api.checkcherry.com`
- URL: `https://api.checkcherry.com/api/v1/questionnaires/create_external`
- Auth: none declared. Required headers: `Api-Key`

Attaches a questionnaire that lives on another site — a Google Form, a Typeform, or your own hosted form. No template is involved and Check Cherry stores no answers; the questionnaire is a name and a link, and the guest is sent to that link to fill it out.

The response carries `kind: "external"` so clients know to open `external_url` directly rather than rendering the Check Cherry form builder. `data.fieldGroups` is empty on these records and `pdf_url` is `null`.

`external_url` may be sent without a scheme — `forms.gle/abc` is stored as `https://forms.gle/abc`. Set `provider` to identify your integration as the source; it is a free-form string and is left blank for links a business adds by hand.

**Required permission:** `assigned_event_write` or `unassigned_event_write`.

## Headers

- `Api-Key` string, required

## Request body

- object
  - `event_id` integer, required: The booking to attach the questionnaire to
  - `title` string, required: Name shown to staff and customers
  - `external_url` string, required: Where the questionnaire is hosted. Assumed to be https when no scheme is given.
  - `provider` string: Optional name of the third party the questionnaire came from

## Response `200`

questionnaire attached

---

[API](https://skmtc.dev/checkcherry/apis/check-cherry-business-api.md) · [All operations](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/revisions/84a9aabdf519?raw)