---
title: "system.mongodb.insertOne"
description: "Inserts a single PyDictionary into a specified collection."
---

# system.mongodb.insertOne

> Inserts a single PyDictionary into a specified collection.

This function is used in **Python Scripting**.

:::note
Project Library scripts will not provide hints for MongoDB system functions unless the Script Hint Scope is set to **Gateway**. See the [Scripting in Ignition](platform\scripting\scripting-in-ignition\scripting-in-ignition.md#system-functions-hints-and-autocomplete) page for more details on scripting hints.
:::

## Description
## Client Permission Restrictions
This scripting function has no [Client Permission](../../../ignition-modules/vision/vision-project-properties/vision-project-properties.md#vision-permissions-properties) restrictions.

## Syntax
`system.mongodb.insertOne(connector, collection, document, [options])`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
String| `connector` | The name of connector (case-insensitive).
String| `collection` | The name of collection (case-sensitive).
PyDictionary| `document` | A PyDictionary of specified fields that will represent a record being added to the collection. [See MongoDB documentation](https://www.mongodb.com/docs/v6.0/core/document/) for more details about documents.
PyDictionary| `options` | A PyDictionary for including additional insert configurations. [optional].

### Returns
**PyObject** `objectId` - Key of inserted document. This will usually be BSON document ObjectId, unless a different key type is specified.

### Scope
Gateway, Perspective Session

## Importing Classes
You can import classes from system.mongodb.types like you would other Python classes:

#### Example
```
from system.mongodb.types import ObjectId
 
newObjectId = ObjectId.get()
```

You can also iterate those system.mongodb.types packages to see all available classes:

#### Example
```
for d in dir(system.mongodb.types):
    print d
```

### API Docs
MongoDB-specific data types come from the org.bson.types package of the Mongo Java Driver API. The library of classes available for import can be accessed at this link: [Mongo Java Driver 3.6.0 API Docs for Package org.bson.types](https://mongodb.github.io/mongo-java-driver/3.6/javadoc/org/bson/types/package-summary.html).

## Types References
The following values can be referenced for the types parameter at system.mongodb.types:
```
Binary
Code
CodeWScope
CodeWithScope
Decimal128
INSTANCE
MaxKey
MinKey
ObjectId
Symbol
Timestamp
```

## Code Examples
```python title="Example #1"
# Import required BSON types.

from system.mongodb.types import ObjectId
from system.mongodb.types import Timestamp

# Specify required document fields in a PyDictionary format for BSON document.
document = {
                "_id": ObjectId(),
                "transaction_count": 0,
                "bucket_start_date": Timestamp(),
                "bucket_end_date": '',
                "transactions": []
                
            }
  
# Apply parameters for function call.
print system.mongodb.insertOne("MongoDB", "transactions", document)
```