> 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/importtasksemail/_setname.md).

# \_setName

Sets the Name of an Email which Tasks will be Imported to.

### Parameters

#### id

The ID of the email.

#### val

The Name of the email.

### Example

```
FM_api('ImportTasksEmail_setName',[
    'id'=>'40123',
    'val'=>'New Task Imports'
    ]
);
```

### Results

#### On Failure

If the "id" parameter is not given a value or has a value less than 1:

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

If the "val" parameter has no value after being trimmed:

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

If the "val" parameter has over 64 characters in length:

```
{"error":"parameter val too long. max length 64"}
```

If the "id" parameter does not match the ID of an existing email:

```
{"error":"that import does not exist"}
```

#### On Success

```
{"ok":1}
```

If the "val" parameter matches the current Name given to the Email:

```
{"ok":1,"warning":"no change required"}
```