# give_money_object

Commands the bot to send money (L$) to a specific object.  
Also see the `give_money` command.

```csharp
// See "LSL Helper Functions" page for this function
smartbotsAPI("give_money_object", [
  "object_uuid", "6e4f1662-19ec-b06c-7625-2c0c2595060f",
  "amount", 10,
  "object_name", ""
]);
```

# 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      | = give_money_object |
| 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 |
|----------|----------|-------------|
| object_uuid | yes      | The UUID of the target object |
| amount   | yes      | The amount of L$ to send |
| object_name | optional | The object’s name (optional; see **Comments**) |

## 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 |

# Comments

Second Life requires the **object name** to be sent with the query.  
However, since **2015/04/02**, the function works even if no object name is specified.


:::info
The bot and the target object **must reside in the same region (sim)**.

:::

# Error messages

The bot returns either:

```
result=OK
```

on success, or:

```
result=FAIL
resulttext=text-string
```

to indicate a problem (e.g., insufficient balance).

# Example

The following example sends **L$10** to an object in-world:

```csharp

string params = llDumpList2String([
  "action="  + "give_money_object",
  "apikey="  + llEscapeURL(sbApiKey),
  "botname=" + llEscapeURL(sbBotName),
  "secret="  + llEscapeURL(sbBotAccessCode),
  "object_uuid="  + "6e4f1662-19ec-b06c-7625-2c0c2595060f",
  "amount=" + "10",
  "object_name=" + ""
], "&");

llHTTPRequest("https://api.mysmartbots.com/api/bot.html",
  [HTTP_METHOD, "POST"], params);
```