---
title: "Insertar nueva fila"
url: https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/data-store/insert-new-row/
description: "Esta API te permite insertar una nueva fila de datos o un registro en una tabla de Data Store."
last_updated: 2026-03-20T16:21:56Z
service: Cloud Scale
type: api
---

# Data Store

[Catalyst Data Store](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/introduction) es un sistema de gestión de bases de datos relacionales basado en la nube que almacena los datos persistentes de tu aplicación en forma de tablas.

Las APIs de Data Store te permiten insertar y gestionar registros en las tablas del Data Store de tu proyecto, obtener detalles de tablas y columnas, e incluso realizar acciones de lectura y escritura masiva. Sin embargo, solo puedes crear una tabla y su esquema desde la consola de Catalyst.

# Insertar una nueva fila en una tabla

### Descripción

Esta API te permite insertar una nueva fila de datos o un registro en una tabla de Data Store, haciendo referencia al ID único o nombre de la tabla.

Debes pasar los nombres de las columnas y sus valores correspondientes para el registro en un array JSON en la solicitud, como se describe a continuación.

> **Nota:** 

* La tabla y las columnas deben estar creadas previamente. Puedes [crear una tabla](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/tables/#create-a-new-table) y las [columnas](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/columns/#create-a-new-column) desde la consola.

* Podrás insertar hasta 5000 registros en cada tabla por proyecto en el [entorno de desarrollo](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/introduction/). Puedes crear hasta 25,000 registros en total en cada proyecto en el entorno de desarrollo. No hay límites superiores para la creación de registros en el entorno de producción.

### Detalles de la solicitud

#### URL de solicitud

`POST` {api-domain}/baas/v1/project/{project_id}/table/{tableIdentifier}/row

- **api-domain** (URL): El dominio específico del DC para acceder a Catalyst API

- **project_id** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/general-settings/) del proyecto

- **tableIdentifier** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/tables/#create-a-new-table) de la tabla o el nombre de la tabla

#### Encabezados de solicitud
 **Authorization:** Zoho-oauthtoken {oauth_token} 

 **Content-Type:** application/json 

**Encabezados opcionales** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### Scope

ZohoCatalyst.tables.rows.CREATE

> **Nota:** Esta operación también se puede ejecutar con permisos de autenticación de usuario de Catalyst usando los SDKs de Catalyst. Consulta la sección [Requisitos previos de Catalyst API](https://docs.catalyst.zoho.com/es/api/introduction/overview-and-prerequisites/#prerequisites) para más detalles.

#### Array JSON de solicitud

Debes enviar los nombres de las columnas y sus valores correspondientes en un **array JSON** de esta manera:

```json

    {
        "column1_name": "column1_value",
        "column2_name": "column2_value",
        "column3_name": "column3_value",
        .
        .
    }
```

donde `column_name` es el nombre de una columna única en la tabla, y `column_value` es su valor correspondiente en el registro.

> **Nota:** Debes enviar al menos un par de nombre y valor de columna para insertar en el registro. 

### Detalles de la respuesta

La respuesta contendrá los metadatos de la fila que se creó, como su `ROWID` y `CREATEDTIME`, y los nombres clave de las columnas y los valores que se insertaron.

**Sample Request**

```bash
curl -X POST \ 
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/table/EmpDetails/row  \
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \
-H "Content-Type:application/json" \
-d '[
       {
         "Department_ID":"IT678",
         "Department_Name":"Marketing", 
         "Employee_Name":"Robert Page"
       }
      ]'

```

**Sample Response**

```json

    {
    "status": "success",
    "data": [
        {
            "CREATORID": "12096000000003003",
            "MODIFIEDTIME": "2023-06-05 11:35:14:332",
            "Department_ID": null,
            "Employee_Name": "Robert Page",
            "Department_Name": "Marketing",
            "CREATEDTIME": "2023-06-05 11:35:14:332",
            "ROWID": 12096000000642928
        }
    ]
}
```

### SDK Documentation

[Insert Rows- Java SDK](https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/data-store/insert-rows)

[Insert Rows- Node.js SDK](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/data-store/insert-rows)

[Insert Rows- Python SDK](https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/data-store/insert-rows)

[Insert Rows- Web SDK](https://docs.catalyst.zoho.com/es/sdk/web/v4/cloud-scale/data-store/insert-rows)