> ## Documentation Index
> Fetch the complete documentation index at: https://www.algolia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a suggestion

> Creates a suggestion of the given type for an application or an index.

This is a **beta feature** according to [Algolia's Terms of Service ("Beta Services")](https://www.algolia.com/policies/terms/).

**Required ACL:** `editSettings`

With an API key, you can only create the types of suggestion that come from user actions, and the request must say who created it with `creation`.
If a matching active suggestion already exists, its lifetime isn't changed.

## Usage

```js JavaScript theme={"system"}
// Initialize the client
// Replace 'us' with your Algolia Application Region
const client = suggestedActionsClient('ALGOLIA_APPLICATION_ID', 'ALGOLIA_API_KEY', 'us');

// Call the API
const response = await client.createSuggestion({ type: 'ACTIVATE_NEURAL_SEARCH', target: { appId: 'MY_APP_ID' } });


// print the response
console.log(response);
```

> [card] [See the full API reference](https://www.algolia.com/doc/rest-api/suggested-actions/create-suggestion.md)
>
> For more details about input parameters
> and response fields.
