> 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/opportunity/_setnotes.md).

# \_setNotes

Sets the Notes in an Opportunity.

### Parameters

#### id

The ID of the Opportunity being modified.

#### val

The notes which will be merged with the Opportunity

### Example

```
FM_api('Opportunity_setNotes',[
  'id'=>'60004',
  'val'=>'test notes'
]);
```

### Results

#### On Success

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

If the "values" parameter is already set to the given value.

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

#### On Failure

If the "id" parameter is not set:

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

If the "values" parameter is not set:

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

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

```
{"error":"opportunity does not exist"}
```