Create Record in Zoho Creator v2.1

Table of Contents

Note: This task is applicable to all services except Zoho Creator.

Overview

The zoho.creator.v2_1.createRecord task creates a new record in a specified Zoho Creator form with the given input field values.

Note: This integration task is based on the Zoho Creator - Add Record API.

Syntax

<response> = zoho.creator.v2_1.createRecord(<owner_name>, <app_link_name>, <form_link_name>, <input_values>, <configuration>, <connection_link_name>);

where,

ParameterData TypeDescription
<response>KEY-VALUE

The response returned by Zoho Creator.

Note: This task internally invokes the Zoho Creator API (v2.1) Add Record endpoint. Therefore, the response returned by this task is identical to the API response, including the code, message, and data (record ID or error details). All API-level limits and validations also apply.
<owner_name>TEXT

Specifies the owner of the Zoho Creator application in which the record will be created.

Note: Name of the application owner can be fetched in the following ways:

  • From the URL of the application while editing or accessing it. The URL is in the format: creator.zoho.com/appbuilder/<application_owner>/...

  • By using the system variable - zoho.adminuser

<app_link_name>TEXT

Link name of the application in which the record will be created.

Note: Link name of the application can be fetched in the following ways:

  • From the URL of the application while editing or accessing it. The URL is in the format: creator.zoho.com/appbuilder/<application_owner>/<application_name>/...

  • By using the system variable -  zoho.appname

<form_link_name>TEXT

Link name of the form in which the record will be created.

Note:

  • Link names of applications, forms, reports, and fields in your account can be viewed on the API reference page.

  • You can also fetch link names from the URL while accessing the form. The URL is in the format: creator.zoho.com/appbuilder/<application_owner>/<application_name>/#Form:<form_link_name>

<input_values>KEY-VALUE

To create a single record, provide the form’s field values as a KEY-VALUE collection, where each key represents a field’s link name and each value represents the data to be stored in that field.

Note: Refer to the Zoho Creator Add Records API document for the rules and validations that your input data need to satisfy.

<configuration>KEY-VALUE

Specifies optional configuration parameters supported by the Add Records API, such as environment, redirection, or workflow settings.

Note: To skip this parameter, pass an empty map or null.
Example: configuration = Map();
<connection_link_name>TEXT

Link name of the connection created and connected to your Zoho Creator account.

Note:

Optional parameters for <configuration>

The following keys can be included within the <configuration> parameter in the createRecord task. These options let you specify additional settings such as environment, redirection behavior, or workflow control.
Each of these parameters can be added to the configuration map that is passed to the task.

ValueData typeDescription
environmentTEXT

Specifies the environment where the record should be created. Accepted values: "development" or "stage". 
This parameter is not required for production environment.

Note: The value here is case sensitive and should be used as such.

tasksBOOLEAN

When this key is included in the configuration with the value true, the response will include details of the form, report, page, or URL to which the target form is configured to redirect after a successful submission.
Redirection can be configured using the direct to form property or a workflow redirection action. The response will include the following keys:

messageBOOLEANWhen the value is true, the response will contain "message":"Data Added Successfully" or the message that's configured for the target form's show message property, or the message that's configured as part of a show message workflow action.
When the value is false or does not include this message key, the response will contain "message":"Data Added Successfully"
skip_workflowLIST

Prevents the associated workflows from being executed on the creation of a record. You can choose to skip form workflows and/or schedules. When more than one type of workflow is mentioned, the parameter values should be supplied as "comma" separated values in a list.

Possible values: form_workflow, schedules, all

Note: If this parameter is not supplied by default, all associated workflows will be triggered.
Blueprints and approvals will be triggered on the creation of records and cannot be skipped. 

Example

A company uses a Zoho Creator app named Task Management to track internal tasks. When a customer submits a query, a task record is created automatically in the Tasks form.

// Create a KEY-VALUE variable to hold the input record values
data_map = Map();
data_map.put("Task_Name", "Priority Task");
data_map.put("Task_Description", "I need help configuring my new toaster");
// Create an empty KEY-VALUE variable or null to skip the other_params parameter
optional_params = Map();
workflows = List();
workflows.add("form_workflow");
workflows.add("schedules");
optional_params.put("environment", "stage");
optional_params.put("tasks", true);
optional_params.put("skip_workflow", workflows);
optional_params.put("message", true);

// Create record
response = zoho.creator.v2_1.createRecord("Shawn","Task_Management","Tasks",data_map,optional_params,"creator_oauth_connection");

Response Format

Success Response

  • The success response will be returned in the following format:
{
"code": 3000,
"data": {"ID": "3893272000000191003"},
"message": "Data Added Successfully"
}

Failure Response

  • The failure response for incorrect or non-existent application name will be returned in the following format:
{
"code": 2892,
"message": "No application named <application_name> found. Please check and try again."
}
  • The failure response for incorrect owner name will be returned in the following format:
{
"code": 1110,
"message": "No workspace named <owner_name> found. Please enter a valid workspace value."
}
  • The failure response for incorrect or non-existent report name will be returned in the following format:
{
"code": 2893,
"message": "No form named <form_link_name> found. Please check and try again."
}

Things to Know

This task is subject to the general API limits and data validation rules:

  • You can create up to 200 records per request.
  • A maximum of 50 requests per minute is allowed per IP address.
  • System fields like Auto Number, Formula, File Upload, and Signature cannot be set manually.
  • All validation rules and mandatory fields apply when creating records.

For full limits and supported field types, see the Zoho Creator API v2.1 documentation.

Related Links