---
title: Create
url: https://www.tines.com/docs/api/records/create/
updated: 2026-06-08T20:10:21+00:00
description: Create a new record.
---

*[tines.com](https://www.tines.com/llms.txt) › [Docs](https://www.tines.com/llms.txt) › [Tines API](https://www.tines.com/llms.txt) › [Records](https://www.tines.com/llm/docs/api/records.md)*

# Create

*[View on tines.com](https://www.tines.com/docs/api/records/create/)*

## Description

Create a new record.

## Request

HTTP Method: **POST**

| Parameter         | Description                                                                                                                                                                                                                                           |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| record_type_id    | Specifies the id of the record type for which the record is being created.                                                                                                                                                                            |
| field_values      | This parameter is an array comprised of objects. Each object must include a `field_id`, which identifies the record field, and a `value`, specifying the data to be assigned to that field for the newly created record.                              |
| case_ids          | **Optional** Specifies the case IDs to link to this record.                                                                                                                                                                                           |
| test_mode         | **Optional** Boolean `true` or `false` value specifying if record being created is related to test stories. Defaults to false.                                                                                                                        |
| resolve_artifacts | **Optional** Boolean `true` or `false` value. When `false`, Artifacts (large text) fields in the response return a reference object containing the artifact ID instead of the full contents. See the [Get Records API](/api/records/get) for details. |

### Field values parameter

| Field values | Description                        |
| ------------ | ---------------------------------- |
| field_id     | The ID of the record field.        |
| value        | The value to set the record field. |

```bash
curl -X POST \
  "https://<tenant-domain>/api/v1/records?resolve_artifacts=false" \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>' \
  -d '{
      "record_type_id": "1",
      "field_values": [{ "field_id": "1", "value": "Test" }],
      "case_ids": ["14","19"]
    }'
```

## Response

A successful request will return a JSON object representing the created record.

### Field description

| Parameter   | Description                                                               |
| ----------- | ------------------------------------------------------------------------- |
| id          | The record ID.                                                            |
| record_type | The record type.                                                          |
| test_mode   | Boolean indicator of whether the record was created in test mode.         |
| records     | The captured data for the given instance of the record type.              |
| created_at  | ISO 8601 Timestamp representing the creation date and time of the record. |
| case_ids    | The case IDs linked to this record.                                       |
| result      | The captured data in key-value format.                                    |

### Sample response

```json
{
  "id": 1973,
  "created_at": "2024-06-25T14:41:23Z",
  "record_type": {
    "id": 1097,
    "name": "Tines Sample Alert"
  },
  "test_mode": false,
  "records": [
    {
      "field_id": "5999",
      "name": "Affected user email",
      "value": "john@example.com"
    },
    {
      "field_id": "5998",
      "name": "Source",
      "value": "Login alerts"
    },
    {
      "field_id": "5997",
      "name": "Description",
      "value": "Suspicious login"
    },
    {
      "field_id": "5996",
      "name": "Severity",
      "value": "High"
    },
    {
      "field_id": "5991",
      "name": "Timestamp",
      "value": "2024-06-25 15:41:23"
    }
  ],
  "case_ids": [14, 19],
  "result": {
    "id": 1973,
    "Affected user email": "john@example.com",
    "Source": "Login alerts",
    "Description": "Suspicious login",
    "Severity": "High",
    "Timestamp": "2024-06-25 15:41:23",
    "case_ids": [14, 19],
    "updated_at": "2024-06-25T14:41:23Z"
  }
}
```