Insert Record In CRM Module Using SDK PHP

The SDK is an open-source PHP library that is used for integrating your PHP application.
Here we learn how to create records with ZOHP REST API using SDK in PHP.

To integrate ZOHO API Using SDK follow below step,

1) you need to create a ZOHO Application. If you have not created then please create it by using the below link:

https://accounts.zoho.com/developerconsole

2) We need to include the vendor/autoload.php file. so first we need to install PHP SDK using composer.

• Run the below command for install composer
  
  To install composer on mac/ Linux system use the below link:

  https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx

  To install composer on Windows system use the below link:

  https://getcomposer.org/doc/00-intro.md#installation-windows

• Install PHP SDK
  1) Give the path of your client app(In which you want to add vendor folder).
  2) Run the command below:

  composer require zohocrm/php-sdk

•   The PHP SDK will be installed and a package named vendor would be created in the workspace of your client app.

3) Now we need to generate a refresh code for security purposes. so  follow steps of the below URL,

https://www.thecodehubs.com/generate-access-code-using-postman-for-zoho

4) Create config.php file and add config file below code

<?php

return array (
  'userIdentifier'         => 'testingtest@gmail.com',
  'client_id'		   => 'put client_register_id',
  'client_secret'          => 'put client_register_secrete_key',
  'redirect_uri'	   => 'http://api.testing.com/sdk/function.php',
  'token_persistence_path' => 'zcrm_oauthtokens.txt',
  'scope'	           => 'ZohoCRM.modules.ALL',
  'refresh_code'	   => '1000.76576b86fd625c202486cdade38692c8.6dc79d9d56a5c0eaf10cd925ea235538',
);

Here,
client_id, client_secret, and redirect_uri that you get after registering your Zoho application.
token_persistence_path is a path for token storage;
The scope is to Choose what data can be accessed by your application.
refresh code is code that is getting from the access token.

5) Create an insert-record.php file and add the below code in this file

<?php
use zcrmsdk\crm\crud\ZCRMInventoryLineItem;
use zcrmsdk\crm\crud\ZCRMRecord;
use zcrmsdk\crm\crud\ZCRMTax;
use zcrmsdk\crm\setup\restclient\ZCRMRestClient;
require 'vendor/autoload.php';

$configs = include("config.php");
$client_id     = $configs['client_id'];
$client_secret = $configs['client_secret'];
$redirect_uri  = $configs['redirect_uri'];
$identifier    = $configs['userIdentifier'];
$token_persistence_path = $configs['token_persistence_path'];

class Create_contacts{
    public function __construct()
    {
        global $client_id, $client_secret, $redirect_uri, $identifier, $token_persistence_path; 
        $configuration = array(
              "client_id"              => $client_id,
              "client_secret"          => $client_secret,
              "redirect_uri"           => $redirect_uri,
              "currentUserEmail"       => $identifier,
              "token_persistence_path" => $token_persistence_path
        );
        ZCRMRestClient::initialize($configuration);
    }
   
    public function createRecords()
    {
        $moduleInsert = ZCRMRestClient::getInstance()->getModuleInstance("{module_name}"); // to get the instance of the module
        $records = array();
        $record = ZCRMRecord::getInstance("{module_name}", null); // To get Record instance
        $record->setFieldValue( "Last_Name", "xyz" ); // set fields value
        $record->setFieldValue( "Account_Name", "4155085001350282060" );
        array_push($records, $record); 
        $responseIn = $moduleInsert->createRecords($records); 
        foreach ($responseIn->getEntityResponses() as $responseIns) {
            echo "HTTP Status Code: " . $responseIn->getHttpStatusCode() . "<br/>"; 
            echo "Status: " . $responseIn->getStatus() . "<br/>"; 
            echo "Message: " . $responseIn->getMessage() . "<br/>"; 
            echo "Code: " . $responseIn->getCode() . "<br/>";
            echo "Details: " . json_encode($responseIn->getDetails());
        }
    }
}

$obj = new Create_contacts();
$obj->createRecords();

Where,
Module_name: The API name of the module
Possible_Module_name: leads, accounts, contacts, deals, campaigns, tasks, cases, events, calls, solutions, products, vendors, price books, quotes, salesorders, purchase orders, invoices, custom, and notes.

While creating new records there are some mandatory fields that you need to mention.