# Create

The create operation is used to create a new entity on an entity set. It typically has two records as input, one containing the required parameters and one containing optional parameters. 

You also have the option to provide custom HTTP headers, if that is applicable. 

With the last parameter "Break workflow on error", you can configure how the machine step will behave in the case of an error. If set to "true" - **do break** workflow - the machine step will stop the execution of the workflow and typically display a dialog with an error message. If set to false - do **not** break - it is up to the workflow designer to check the StatusCode member of the result (and/or ErrorMessage) and decided whether to abort the workflow, try again, or just ignore it.

![Create entity](/files/WZo8dWeqTKUEeIAjjdF8)

There is usually also the option to run the operation in the context of an iterator. 

## Output

The result (a record) of the operation looks like this:

* StatusCode - the HTTP status code returned from the OData endpoint, typically **201** if the operation was successful. A value of 0 or -1 indicates a problem in the connector (i.e, no request sent to the OData endpoint)
* ErrorMessage - has no value if the operation succeeded, otherwise a description of what when wrong
* HasFailed - simple value containing true if operation failed
* Entity - a record containing the values of the created entity, including the values of auto-generated columns.
* Descriptor - is omitted by default, but if included,  contains OData-related information about the entity, such as ETag and the identity of the created entity
* Headers - is omitted by default, but if included, contains all HTTP headers returned by the OData endpoint


---

# 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://help.novacuraflow.com/connectors/areas/business-systems/ifs-applications/ifs-odata/operations/create.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.