> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# forms_create

> Create a new form from a title. Only the title and the document title are honoured: the form is created with no description, no items and default settings. To add questions, call this and then forms_batch_update with the returned formId. Pass unpublished=true to create a form that does not yet accept responses.

<div className="tool-route"><span className="tool-row-method" data-method="POST">POST</span><code>{"https://forms.googleapis.com/v1/forms"}</code></div>

```python gforms_forms_create.py theme={null}
from charter.packs import gforms

result = await gforms.forms_create.ainvoke({"body": ...})
```

<Note>
  Requires `https://www.googleapis.com/auth/forms.body`. Costs 1 against the provider's own quota.
</Note>

## Query parameters

<div className="reference-table">
  | Field         | Type      | Description                                                                                                                                                              |
  | ------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | `unpublished` | `boolean` | Optional. Whether the form is unpublished. If set to `true`, the form doesn't accept responses. If set to `false` or unset, the form is published and accepts responses. |
</div>

## Body

<div className="reference-table">
  | Field                                                        | Type                                                                   | Description         |
  | ------------------------------------------------------------ | ---------------------------------------------------------------------- | ------------------- |
  | `body` <span className="required" title="required">\*</span> | [FormsCreateBody](/charter/charter/packs/gforms/forms/objects#formscreatebody) | The form to create. |
</div>