Creator API

XML RPC API - Edit Records

URL

https://creator.zoho.com/api/xml/write

HTTP Method

POST

Parameters

Parameter Name Usage Description
authtoken Required. A valid API authtoken. Refer https://api.creator.zoho.com/Generate-Auth-Token.html for generating authtoken.
scope Required Specify the value as creatorapi
zc_ownername Optional. The application owner's name. Required if the record is being edited by a shared or public user
<application name> Required. The name of the application that contains the form. Multiple applications can be updated at a time.
<form name> Required. The name of the form to edit records in. Multiple forms in an application can be updated at a time.
<field name> Required. The link name of the field. This parameter's value specifies the value to be set for that field.

Refer to this page for the link names used in your applications.

Prerequisites

Notes

  • Anyone with a valid Auth token can add a record to a public Form.
  • Only the owner of the application can add a record to a private Form.
  • You can add records to multiple applications and multiple forms at a time.
  • Multiple picklist values must be specified within the <options> tag and each value must be specified in <option>tag.

Sample Request

<form method="POST" action="https://creator.zoho.com/api/xml/write" >
 <input type="hidden" name ="authtoken" value="************">
 <input type="hidden" name ="scope" id="scope" value="creatorapi">
 <textarea name="XMLString" >
  <ZohoCreator>
    <applicationlist>
        <application name='sample'>
            <formlist>
                <form name='Employee'>
                    <update>
                        <criteria>
                            <![CDATA[(Name == "Jean" && DOB == "20-Jul-1981")]]>
                        </criteria>
                        <newvalues>
                            <field name='Basic'><value>34000</value></field>
                            <field name='Address'><value>UK</value></field>
                        </newvalues>
                    </update>
                </form>
            </formlist>
        </application>
    </applicationlist>
</ZohoCreator>
</textarea>
<input type="hidden" name="zc_ownername" value="sampleapps">
<input type="submit" value="Update Record">
</form>

Sample Response

XML response

<?xml version="1.0" encoding="UTF-8" ?>
<response>
    <result>
        <form name="Employee">
          <update>
            <criteria>
                (Name == "Jean" && DOB == "20-Jul-1981")
            </criteria>
            <newvalues>
                <field name='Basic'>
                    <value>34000</value>
                </field>
                <field name='Address'>
                    <value>UK</value>
                </field>
            </newvalues>
                <status>Success</status>
            </update>
        </form>
    </result>
</response

Error Codes

If there is an error in the request format, the corresponding error code with error message will be displayed. Please refer to the topic Error codes and descriptions for the list of error codes. If the operation is successful, the response message will be displayed with status as "Success".

Top