# Save Record

This action will insert a new record or update specific fields of an existing record on a collection.

<figure><img src="/files/Em5Gs46YQiJ3Yv8Tif9V" alt=""><figcaption></figcaption></figure>

### Settings

The action uses the following settings:

| Setting          | Description                                                                                                                                                     | [Parsed](/actions-and-operations/dynamic-parsing.md) |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| Bot              | The bot that is providing collection access. The current bot is selected by default.                                                                            | :no\_entry:                                          |
| Collection       | The collection to be used for the action                                                                                                                        | :no\_entry:                                          |
| Save Mode        | Set whatever the save action should fully replace any data in the existing record or only update the specified fields                                           | :no\_entry:                                          |
| Record Unique Id | The unique id of the record to be deleted. If left empty,[ Filter Operations](/actions-and-operations/database/set-field-filter-value.md) will be used instead. | :white\_check\_mark:                                 |

### Remarks

This action alone does not produce any result. At least one [Field Operation](/actions-and-operations/database/set-field-value.md) must be attached for the action to be executed. Assuming we want to increase by 50 the cost of a product with a specific id, a complete Save Record action may look like the example below:&#x20;

![](/files/-M_bX-404YJjqwBwP9h9)

If no unique id is specified for the record or no record exist with the specified value, the Save Mode will be automatically set to replace whole record mode.

### Trigger

This action automatically triggers all of the [Set Field operations](/actions-and-operations/database/set-field-value.md) attached.

### Variables

This action produces the following variables after being triggered:

| Variable                   | Description                                                    |
| -------------------------- | -------------------------------------------------------------- |
| last\_database\_object\_id | The unique id of the record that has been updated or inserted. |

### Availability

Channel specific availability follows the table below:

| Channel          | Availability     |
| ---------------- | ---------------- |
| Facebook         | Fully Available. |
| WhatsApp         | Fully Available. |
| SMS              | Fully Available. |
| Telegram         | Fully Available. |
| Web              | Fully Available. |
| Alexa            | Fully Available. |
| Google Assistant | Fully Available. |
| Slack            | Fully Available. |
| API              | Fully Available. |

This action requires an active [Database ](broken://pages/-LdYpe93z-UqrvvQdX7V)package.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mylinkconnect.com/actions-and-operations/database/save-record.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
