> For the complete documentation index, see [llms.txt](https://synconics.gitbook.io/rest-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://synconics.gitbook.io/rest-api/calling-methods/create-records.md).
# 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 | |
| Status Codes | |