# Create a record

`POST /api/v1/objects/{key}/records`

Creates a record. Required fields and options are validated on the server (`invalid`, listed one by one in `errors`). With `customer_id` the object's company relation is set; `links` sets other relations (relation key → target id or array of ids). Fires the `record_created` workflow and webhook event.

## Path parameters

| Field | Type | Description |
|---|---|---|
| `key` (required) | string | Object key. |

## Body

| Field | Type | Description |
|---|---|---|
| `name` (required) | string | Record name (the object's name field, e.g. *Line name*). |
| `customer_id` | integer | Linked company. |
| `fields` | object | Field key → value. |
| `links` | object | Relation key → target id(s). |

## Response

```json 200
{
  "ok": true,
  "record": {
    "active": true,
    "customer": {
      "id": 1,
      "name": "Alize Paketleme San. ve Tic. A.Ş."
    },
    "editable": true,
    "field_list": [
      {
        "display": "Ekstrüzyon",
        "key": "makine_tipi",
        "label": "Makine tipi",
        "options": [
          "Laminasyon"
        ],
        "required": true,
        "type": "select",
        "value": "Ekstrüzyon"
      }
    ],
    "fields": {
      "devreye_alma": "2025-04-01",
      "hiz": 180.0,
      "makine_tipi": "Ekstrüzyon"
    },
    "id": 1,
    "name": "Hat 3 — şişirme",
    "owner": "Deniz Aksoy",
    "owner_id": 1,
    "relations": [
      {
        "items": [
          {
            "id": 1,
            "name": "Alize Paketleme San. ve Tic. A.Ş."
          }
        ],
        "key": "co1_customer",
        "kind": "customer",
        "label": "Firma",
        "many": false,
        "side": "a",
        "target_label": "Firma"
      }
    ],
    "sub": "Ekstrüzyon · 180",
    "updated_at": "2026-10-06T10:26:24",
    "url": "https://ornek.solk.app/o/uretim_hatti/1"
  }
}
```