# Create Records Records of a model are created using [create()](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html#odoo.models.Model.create). It takes a mapping of fields to values, used to initialize the record. For any field which has a default value and is not set through the mapping argument, the default value will be used. **Warning** while most value types are what would be expected (integer for [Integer](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html#odoo.fields.Integer), a string for [Char](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html#odoo.fields.Char) or [Text](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html#odoo.fields.text)), * [Date](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html#odoo.fields.Date), [Datetime](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html#odoo.fields.Datetime) and `Binary` fields use string values * [One2many](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html#odoo.fields.One2many) and [Many2many](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html#odoo.fields.Many2many) use a special command protocol detailed in the documentation for the [write](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html#odoo.models.Model.write) method. **`POST /restapi/1.0/object/{object_name}?vals={values_for_the_object's_fields}`** **Request:** ``` POST /restapi/1.0/object/res.partner?vals={'name':'Peter Mitchell','street':'31 Hong Kong street','city':'Taipei','zip':'106','country_id':482} HTTP/1.1 Host: ``` **JSON Response:** ``` HTTP/1.1 200 OK { 'Partner': { 'id': 20, 'name': 'Peter Mitchell', 'street': '31 Hong Kong street', 'street2': false, 'city': 'Taipei', 'state_id': false, 'zip': '106', 'country_id': [482, 'Taiwan'], 'create_date': '2017-07-12 13:34:22', 'create_uid': [1, 'Administrator'], 'write_date': '2017-07-12 13:34:22', 'write_uid': [1, 'Administrator'], ... ... ... } } ``` **XML Response:** ``` HTTP/1.1 200 OK 20 Peter Mitchell 31 Hong Kong street false Taipei false 106 482 Taiwan 2017-07-12 13:34:22 1 Administrator 2017-07-12 13:34:22 1 Administrator ``` **Query Parameters:** * **vals** – values for the object’s fields, as a dictionary:: `{'field_name': field_value, ...}` see [write()](https://www.odoo.com/documentation/16.0/developer/reference/backend/orm.html#odoo.models.Model.write) for details. | Headers and Status Codes | Description | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Request Headers |

Accept – the response content type depends on Accept header
Authorization – The OAuth protocol parameters to authenticate.

| | Response Headers |

Content-Type – this depends on Accept header of the request

| | Status Codes |

200 OK – no error
404 Not Found – there’s no resource
401 Unauthorized – authentication failed
403 Forbidden – if any error raise

| --- # 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://synconics.gitbook.io/rest-api/calling-methods/create-records.md?ask= ``` 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.