# notecard_create

Creates a notecard in the bot's inventory.

```csharp
// See "LSL Helper Functions" page for this function
smartbotsAPI("notecard_create", [
  "folder", "b572d860-c5cf-e023-a6b2-408f30266acc",
  "name", "My new notecard",
  "description", "This is a test notecard description",
  "text", "Hello!\nThis is a new line but also the contents of my new notecard!"
]);
```

# Variables

The following table shows input values (you send them with the API call) and returned output values.

## Input basic parameters

| Variable | Required | Description |
|----------|----------|-------------|
| action   | yes      | = notecard_create |
| apikey   | yes      | Your personal [developer's API key](/doc/developers-api-key-tw8bQj4LSJ) |
| botname  | yes      | Your bot's SL login |
| secret   | yes      | [Bot access code](https://www.mysmartbots.com/docs/Bot_access_code) of your bot |
| dataType | optional | Set to "json" to get JSON reply instead of URL-encoded string |
| custom   | optional | The custom data (string) to be passed back to caller script. This value will be returned back to the caller in HTTP response |

## Input

| Variable | Required | Description |
|----------|----------|-------------|
| folder   | optional | UUID of an inventory folder where the notecard will be created.<br>If left blank, the notecard will be created in the “Notecards” folder within your bot's inventory. |
| name     | yes      | Name of the notecard |
| description | optional | An optional description for the notecard |
| text     | yes      | The contents of the notecard |

## Output

*(To be received in* `*http_response*` *LSL event, see* [*docs for details*](/doc/doing-http-api-calls-c6FSEMF7bP)*)*

| Variable | Description |
|----------|-------------|
| result   | OK - command completed successfully<br>FAIL - command failed |
| resulttext | Detailed reason for the failure |
| custom   | The value from input "custom" parameter. See above |
| uuid     | The UUID of the newly created notecard |

# Example

Create a notecard in the given folder UUID.

(The example uses the `smartbotsAPI()` helper function. Set your `apikey`, `botname`, and `secret` in that function.)

```csharp
// See "LSL Helper Functions" page for this function
smartbotsAPI("notecard_create", [
  "folder", "b572d860-c5cf-e023-a6b2-408f30266acc",
  "name", "My new notecard",
  "description", "This is a test notecard description",
  "text", "Hello!\nThis is a new line but also the contents of my new notecard!"
]);
```