> For the complete documentation index, see [llms.txt](https://docs.fieldmotion.com/fieldmotion-api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fieldmotion.com/fieldmotion-api-docs/formblock/_new.md).

# \_new

Creates a new Form Block.

### Parameters

#### name

The name which will be given to the new Form Block.

### Example

```
FM_api('FormBlock_new', [
        'name' => 'new name'
    ]
);
```

### Results

#### On Success

```
{"ok":1,"id":100,"name":"name","type":0}
```

#### On Failure

If the "name" parameter is not set:

```
{"error":"missing or invalid parameter: name"}
```

If the "name" parameter is set but is blank after being trimmed:

```
{"error":"no name returned"}
```

If the "type" parameter has a value higher than 1:

```
{"error":"invalid form_block type supplied"}
```

If a Form Block with the chosen name already exists:

```
{"id":100,"error":"A form or email block with that name already exists"}
```