# mongoc_collection_create_bulk_operation_with_opts()¶

## Synopsis¶

mongoc_bulk_operation_t *
mongoc_collection_create_bulk_operation_with_opts (
mongoc_collection_t *collection,
const bson_t *opts) BSON_GNUC_WARN_UNUSED_RESULT;


## Parameters¶

opts may be NULL or a BSON document with additional command options:

## Description¶

This function shall begin a new bulk operation. After creating this you may call various functions such as mongoc_bulk_operation_update(), mongoc_bulk_operation_insert() and others.

After calling mongoc_bulk_operation_execute() the commands will be executed in as large as batches as reasonable by the client.

Bulk Write Operations

mongoc_bulk_operation_t

## Errors¶

Errors are propagated when executing the bulk operation.

## Returns¶

A newly allocated mongoc_bulk_operation_t that should be freed with mongoc_bulk_operation_destroy() when no longer in use.

Warning

Failure to handle the result of this function is a programming error.