Automating Vendor Contract Management between Zoho Contracts and Zoho Books using Zoho Flow

Managing vendor agreements across procurement and finance systems often requires manually downloading executed contracts and attaching them to vendor records. This can become time-consuming and difficult to manage when dealing with a large number of contracts.

In this post, we’ll share a simple automation built using Zoho Flow, Zoho Contracts APIs, and Zoho Books that connects procurement, legal, and finance workflows.

This integration automatically:

1. Creates counterparties and contracts in Zoho Contracts when a vendor is added in Zoho Books
2. Detects when a contract is executed in Zoho Contracts
3. Downloads the executed contract
4. Attaches the signed contract to the vendor record in Zoho Books

This enables a seamless Procure-to-Pay vendor contract workflow and demonstrates how Zoho Contracts can be integrated with finance systems to streamline vendor agreement management.

Business Use Case – Procure to Pay

A typical vendor agreement lifecycle involves:

1. Vendor onboarding in Zoho Books
2. Contract creation, negotiation, and execution in Zoho Contracts
3. Executed agreement available for the finance team’s reference

Without automation, finance teams must manually download the executed agreement and attach it to the vendor record.

Prerequisites

Before implementing this automation, ensure the following setup is completed:

1. Zoho Books and Zoho Contracts are configured in your organization
2. Zoho Flow is enabled and connected to both Zoho Books and Zoho Contracts
3. API connections are configured for Zoho Books and Zoho Contracts in Zoho Flow
4. Appropriate permissions are available to create counterparties and contracts in Zoho Contracts
5. Additionally, create a custom field in Zoho Books (Vendor module) to store the Zoho Contracts Counterparty API Name.

Example:

1. Field Name: Contracts Counterparty ID
2. Field Type: Text
3. Module: Vendors

This field helps map vendors in Zoho Books with their corresponding counterparties in Zoho Contracts.

Solution Overview

Zoho applications involved:

1. Zoho Contracts
2. Zoho Books
3. Zoho Flow

The automation is implemented using two flows.

Flow 1 – Vendor Creation → Contract Creation

Trigger: A new vendor is created in Zoho Books.

Actions:

1. Zoho Flow detects the new vendor.
   

1. A custom function checks whether a corresponding counterparty exists in Zoho Contracts
2. If the counterparty does not exist, a new counterparty is created in Zoho Contracts

1. The counterparty API name is stored in Zoho Books
2. A contract is automatically created in Zoho Contracts for that vendor
   
   

Custom Function Snippet (Create Counterparty and Contract):

Note: The custom functions shared below are working reference implementations. However, depending on your environment, you may need to update certain values before using them in your setup.

Please review and update the following as applicable:

1. Connection names used in the invokeurl statements
2. Organization ID used for Zoho Books API calls
3. Custom field API names used to store the Counterparty reference in Zoho Books
4. Contract type API names configured in Zoho Contracts

Ensure these values are updated according to your configuration before deploying the automation

.

1. map createContract1(string vendorName, string vendorID, string counterpartyID)
2. {
3. result = Map();
4. createdCounterPartyAPIName = "";
5. if(counterpartyID != null && counterpartyID != "")
6. {
7.  existingCounterpartyResponse = invokeurl
8.  [
9.   url :"https://contracts.zoho.in/api/v1/counterparties/" + counterpartyID
10.   type :GET
11.   connection:"zcontractsconn"
12.  ];
13.  if(existingCounterpartyResponse.get("counterparty") != null)
14.  {
15.   createdCounterPartyAPIName = existingCounterpartyResponse.get("counterparty").get("apiName");
16.  }
17. }
18. if(createdCounterPartyAPIName == "")
19. {
20.  counterpartyMap = Map();
21.  counterpartyMap.put("name",vendorName);
22.  counterpartyMap.put("counterPartyType","vendor");
23.  createResponse = invokeurl
24.  [
25.   url :"https://contracts.zoho.in/api/v1/counterparties"
26.   type :POST
27.   parameters:counterpartyMap.toString()
28.   connection:"zcontractsconn"
29.  ];
30.  counterpartyDetail = createResponse.getJSON("counterparties").get(0);
31.  createdCounterPartyAPIName = counterpartyDetail.get("organizationApiName");
32.  customFields = List();
33.  cf = Map();
34.  cf.put("api_name","cf_contracts_counterparty_id");
35.  cf.put("value",createdCounterPartyAPIName);
36.  customFields.add(cf);
37.  updateMap = Map();
38.  updateMap.put("custom_fields",customFields);
39.  updateVendor = invokeurl
40.  [
41.   url :"https://books.zoho.in/api/v3/vendors/" + vendorID + "?organization_id=60047651581"
42.   type :PUT
43.   parameters:updateMap
44.   connection:"zbooks"
45.  ];
46. }
47. info "STEP 4 STARTED - Preparing Contract Variables";
48. newContractType = "master-subscription-agreement-pro-plus";
49. newContractName = "Agreement with " + vendorName;
50. isNewContractTermIsDefinite = false;
51. isNewContractRenewable = false;
52. contractEffectiveDate = 1;
53. info "Contract Type: " + newContractType;
54. info "Contract Name: " + newContractName;
55. info "Counterparty API Name: " + createdCounterPartyAPIName;
56. newContractDetail = {"externalSource":true,"inputfields":{{"metaApiName":"contract-type","inputs":{{"inputApiName":"contract-type","inputValue":newContractType}}},{"metaApiName":"contract-term","inputs":{{"inputApiName":"contract-term","inputValue":isNewContractTermIsDefinite}}},{"metaApiName":"is-renewable","inputs":{{"inputApiName":"is-renewable","inputValue":isNewContractRenewable}}},{"metaApiName":"title","inputs":{{"inputApiName":"title","inputValue":newContractName}}},{"metaApiName":"party-b-name","inputs":{{"inputApiName":"party-b-name","inputValue":createdCounterPartyAPIName}}},{"metaApiName":"contract-effective-date","inputs":{{"inputApiName":"contract-effective-date","inputValue":contractEffectiveDate}}}}};
57. createContractResponse = invokeurl
58. [
59.  url :"https://contracts.zoho.in/api/v1/createcontract"
60.  type :POST
61.  body:newContractDetail.toString()
62.  headers:{"Content-Type":"application/json"}
63.  connection:"zcontractsconn"
64. ];
65. info createContractResponse;
66. result.put("counterpartyApiName",createdCounterPartyAPIName);
67. result.put("contractResponse",createContractResponse);
68. return result;
69. }

Flow 2 – Contract Execution → Attach Signed Agreement

Trigger: Contract signing is completed in Zoho Contracts

Actions: 

1. Zoho Flow detects the contract execution event
   

1. A custom function calls the Zoho Contracts API to download the executed contract document.
2. The function identifies the corresponding vendor in Zoho Books.
3. The executed agreement is automatically attached to the vendor record in Zoho Books.
   
   

Custom Function Snippet (Retrieve and Attach Signed Contract):

1. map attachSignedContractToVendor(string contractApiName, string contractTitle)
2. {
3. result = Map();
4. orgID = "60047651581";
5. 
   
6. info "FLOW 2 STARTED";
7. info contractApiName;
8. info contractTitle;
9. 
   
10. if(contractApiName.startsWith("contract/"))
11. {
12.     contractApiName = contractApiName.replaceAll("contract/","");
13. }
14. 
    
15. info "Clean Contract API Name: " + contractApiName;
16. 
    
17. if(contractTitle.startsWith("Agreement with "))
18. {
19.     vendorName = contractTitle.subString(15);
20. }
21. else
22. {
23.     vendorName = contractTitle;
24. }
25. 
    
26. info "Vendor Extracted: " + vendorName;
27. 
    
28. vendorSearch = invokeurl
29. [
30.     url :"https://books.zoho.in/api/v3/contacts?contact_name=" + vendorName + "&organization_id=" + orgID
31.     type :GET
32.     connection:"zbooks"
33. ];
34. 
    
35. info vendorSearch;
36. 
    
37. contactsList = vendorSearch.get("contacts");
38. 
    
39. if(contactsList == null || contactsList.size() == 0)
40. {
41.     info "Vendor not found";
42.     result.put("status","vendor_not_found");
43.     return result;
44. }
45. 
    
46. vendorID = contactsList.get(0).get("contact_id");
47. 
    
48. info "Vendor ID: " + vendorID;
49. 
    
50. info "Downloading signed contract";
51. 
    
52. signedFile = invokeurl
53. [
54.     url :"https://contracts.zoho.in/api/v1/download/contracts/" + contractApiName + "/signed/document"
55.     type :GET
56.     connection:"zcontractsconn"
57. ];
58. 
    
59. info signedFile;
60. 
    
61. fileMap = Map();
62. fileMap.put("attachment",signedFile);
63. fileMap.put("organization_id",orgID);
64. 
    
65. info "Uploading attachment to Zoho Books";
66. 
    
67. uploadResponse = invokeurl
68. [
69.     url :"https://books.zoho.in/api/v3/contacts/" + vendorID + "/attachment?organization_id=" + orgID
70.     type :POST
71.     parameters:fileMap
72.     connection:"zbooks"
73.     content-type:"multipart/form-data"
74. ];
75. 
    
76. info uploadResponse;
77. 
    
78. result.put("uploadResponse",uploadResponse);
79. 
    
80. info "FLOW 2 COMPLETED";
81. 
    
82. return result;
83. }

Benefits

1. This automation provides several advantages:
2. Eliminates manual document handling
3. Ensures finance teams always have access to executed agreements
4. Connects legal and finance workflows
5. Improves compliance and audit readiness
6. Reduces operational friction

Closing

If you're implementing Procure-to-Pay contract workflows, this approach can help streamline the connection between Zoho Contracts and finance systems like Zoho Books.

We’d be happy to discuss variations of this implementation or answer any questions.

If you're planning to implement a similar workflow and need guidance, feel free to reach out to the Zoho Contracts support team at support@zohocontracts.com.

.

Stay tuned for more tips, tricks, and automation ideas around Zoho Contracts.

Cheers,

Sathyakeerthi

Zoho Contracts Team

• Topic Participants

• Sathyakeerthi U

  

• Sticky Posts

• Adding signature fields in your contract template

  When you send a contract document for the signing process, you have to insert the signature fields into your contract document by dragging and dropping them for each signer. It won't be effort-intensive for contracts that have fewer pages or signers.

• Mapping Billing Country Field to Your Contract Template Field

  In Zoho CRM, while configuring Counterparty Fields Mapping to map counterparty information in your contract type, the field 'Billing Country' doesn't have the support to be mapped due to field type mismatch. Because the Billing Country field in Zoho CRM

• Bulk Import Counterparty Data

  Currently, as the feature to bulk import counterparty data is not available, here is a solution using our APIs that would be useful for our customers. For example, Zoho CRM customers can import their Accounts as counterparties in Zoho Contracts. Using

• Recent Topics

• Native QuickBooks integration for Zoho CRM: Connecting sales and finance

  Greetings, I hope all of you are doing well. We're excited to announce Zoho CRM's integration with QuickBooks Web, which is designed to synchronize your CRM data with your QuickBooks accounting records and bridge the gap between sales and finance. This

• Edit a previous reconciliation

  I realized that during my March bank reconciliation, I chose the wrong check to reconcile (they were for the same amount on the same date, I just chose the wrong check to reconcile). So now, the incorrect check is showing as un-reconciled. Is there any way I can edit a previous reconciliation (this is 7 months ago) so I can adjust the check that was reconciled? The amounts are exactly the same and it won't change my ending balance.

• BUG: Related List Buttons with Client Script action now erroring

  There appears to have been a bug introduced over the last few days with Related List buttons that invoke a Client Script action. Button configuration: Configured Client Script: Results: The default loader is presented at the top of the page, and an error

• Zoho Writer extension is now available in Zoho Books!

  The Zoho Writer extension is now available in Zoho Books. With this, you can design documents your way. Create custom templates with Zoho Writer in Zoho Books. Instantly generate multiple templates for invoices, estimates, and purchase orders. Easily

• Paste Options don't work

  I've always wondered about this, as I've experienced this issue for quite some time now. Why don't the right-click Paste options work properly in Zoho Writer? I can use Ctrl + V without any issue, but if I right-click and use one of the Paste menu options,

• What's New in Zoho Analytics - April 2026

  Hello Users! April brings a fresh set of updates and enhanced capabilities designed to make your analytics more intuitive and efficient. Explore What's New! Zia Insights in Dashboards We’re bringing the power of Zia Insights directly into dashboards.

• Issue with Resume Parsing and Storage Limit in Zoho Recruit

  Hello Team, We are currently facing an issue with resume parsing in Zoho Recruit. While parsing resumes, we are receiving a message indicating that the storage is full. We would like to delete multiple old resumes from the system to free up storage space.

• Introducing Custom Columns in Forecasts in Zoho CRM

  Release Plan: Enabling in Phased Manner, Enabled for JP DC Hello all, Forecasts in Zoho CRM help sales representatives, managers, and business stakeholders evaluate performance and plan future sales activities. While standard metrics such as Target, Achieved

• Integrate QuickBooks with Bigin and streamline your sales and accounting!

  If your business relies on Bigin for customer management and QuickBooks for accounting and invoicing, this new integration is here to make your operations more efficient. By connecting these two platforms, you can now manage your CRM and financial processes

• What's New in Zoho Billing | April 2026

  April 2026 brings a wide set of updates to Zoho Billing, from updated Payment Links layout and AI-powered billing workflows to smarter subscription quoting, better compliance tools for German Edition users, and more. Here's everything that's new. Connect

• No Ability to Rename Record Template PDFs in SendMail Task

  As highlighted previously in this post, we still have to deal with the limitation of not being able to rename a record template when sent as a PDF using the SendMail Task. This creates unnecessary complexity for what should be a simple operation, and

• Need Native Support for docx files in Zoho Writer

  Absolutely love Zoho Writer, but often need to share files by email with people who are in the Office ecosystem. Downloading a file as docx, then sending it by email, getting the comments back, converting it to Zoho format, editing it, then converting

• Invalid value passed for line_item_category

  duplicating a previous used invoice and trying to save it (new invoice number / po number used) I keep encountering this error when trying to save the invoice Invalid value passed for line_item_category

• What is the different between Zoho invoice and Zoho book

  Hi, both product do invoice and Zoho book having all function / feature Zoho invoice, please explain more, thanks

• Mastering Zia Match Scores | Let's Talk Recruit

  Feeling overwhelmed by hundreds of resumes for every job? You’re not alone! Welcome back to Let’s Talk Recruit, where we break down Zoho Recruit’s features and hiring best practices into simple, actionable insights for recruiters. Imagine having an assistant

• Option for - CSV Export from Pipeline Deals by Stage (Including Products, Companies, and Contacts)

  I would like to know when we will be able to export a simple CSV file from pipeline deals, with the option to select a specific stage within the pipeline. This export should include data for products, companies, and contacts, all in a single view. For

• What is the difference between workflows, journeys, and blueprints?

  I semi-understand what they are individually but they all say they can be used to automate processes in your CRM. What makes these three different? What are the benefits and cons of using each?

• Free webinar! Simplify hiring and HR workflows with Zoho Sign for Zoho People & Zoho Recruit

  Hello! Managing recruitment, onboarding, and employee paperwork doesn’t have to be complex or time-consuming. Discover how Zoho Sign, integrated with Zoho People and Zoho Recruit, helps you digitize and streamline your document workflows from hire to

• Multiple Blueprints on different fields at the same time.

  It looks only 1 Blueprint can run at the same time, it makes sense for many Blueprints on the same field (Eg. Stage). But what about multiple Blueprints on "different" fields? the multiple options must be available. (Eg. Stage, Documents Status, Contract

• Edit 'my' Notes only

  The permissions around Notes should be more granular, and allow to user to be able to edit the notes he created only. The edit Notes permission is useful as it allows the user to correct any mistakes or add information as needed. However, with this same

• Need to make a specific canvas my default view for contacts

  Need to make a specific canvas my default view for contacts How do I do it?

• Add Zia matching jobs on the main screen of candidates module

  It will be good if it is added in the main screen as a column so that we can quickly hover over and see if they match for any job openings. That will save from two additional clicks

• Domain Disclaimer: A standardized footer for your entire organization

  Every email sent from an organization represents its identity externally. Most teams require consistent line of text at the bottom of outgoing messages. It can be a confidentiality notice, a legal statement, a compliance requirement, or a uniform sign-off.

• Zia flags the deal as at risk - but leaves my customers figuring out the rest themselves

  I implement Zoho for many businesses. Team sizes vary, some clients have 3 reps, some have 40. But I keep hearing the same complaint across all of them and I figured it's worth raising here. Zia's deal scoring has genuinely improved over the past year.

• How do we change system field names?

  I found some very old discussions, but looking for more recent. Very confused on mapping the addresses correctly, due to different names for some reason between. for example: leads: city, state, zip etc... as normal contacts: Mailing adddress & Other

• Remove "Subject" as a required field on Quotes

  Currently, when you create a quote in CRM, the field "Subject" is mandatory. The properties of a system defined field cannot be edited which means we cannot de-select the mandatory requirement. A 'subject' on a quote is a little vague and not something

• Adding Multiple Products (Package) to a Quote

  I've searched the forums and found several people asking this question, but never found an answer. Is ti possible to add multiple products to a quote at once, like a package deal? This seems like a very basic function of a CRM that does quotes but I can't

• Unattended - Silent

  How can I hide the tray icon / pop up window during unattended remote access for silent unattended remote access?

• What is the Potential field for in expense submissions?

  I'm trying out Zoho Expense in Zoho Project so I can record project expenses which aren't time related. On the expense form there is an option called Potential but I don't understand what this is for. When I click the dropdown it just shows the name of

• Pasting Images in Zoho Desk ignores cursor location

  My team has reported an issue which started recently where when we paste an image into a new or existing reply or comment, the pasted image seems to ignore the current cursor location instead paste itself at the last character present in the reply/comment,

• how do i add more than one google my business location?

  they are connected to one account, but while connecting social channels it makes me pick one location. I have 3 and growing.

• Unable to switch existing AWS RDS connection to DataBridge after moving RDS behind VPN

  Hi everyone, I’m facing a problem with an existing Zoho Analytics setup and would like to know the best migration path. Originally, my Zoho Analytics connection to AWS MySQL RDS was configured using direct public access to the RDS endpoint. Everything

• Hotmail

  I am sending an email to a hotmail, and this guy does not receive the email, either in his SPAM nor inbox. Can you help me? thanks!

• Updating Sales orders on hold

  Surely updating irrelevant fields such as shipping date should be allowed when sales orders are awaiting back orders? Maybe the PO is going to be late arriving so we have to change the shipment date of the Sales order ! Not even allowed through the api - {"code":36014,"message":"Sales orders that have been shipped or on hold cannot be updated."}

• How do I change the Subject header when I reply please, it contains Re which I want to remove.

  Hi Zohodesk, When a customer logs a call we have amended the Acknowledge on new Ticket template so the subject header has "Ticket Id" at the start of it.  When we reply the customer gets Re: and then the Id and I can't see a template for this? Can you

• Zia Agent built in ChatKit UI does not render markdown

  Hi, You have a major shortcoming in the Zia Agent UI. The test UI that is embedded in agents.zoho.com allows you to test the agent has full support for rendering markdown, but your ChatKit UI does not have support for rendering markdown. If I embed it

• Automated entries past the current month in a calendar report

  Hi all, I have an automation problem. I have a form which on successfull entry adds either 5 or 10 more of these entries with a slight change so our customers can see it throug a calendar report on the webiste. The entry put in manually shows up perfectly

• [Bug] WebAuthn passkey registration blocked on rpIds with TLDs longer than 6 characters (.accountant, .technology, etc.) — isValidDomain regex too strict

  Hi, Filing on behalf of an enterprise customer where Zoho Vault is deployed across the company. The Chrome extension blocks WebAuthn passkey registration on legitimate sites whose Relying Party ID (rpId) has a TLD longer than 6 letters. This affects every

• Get Files Associated to Data Template via API

  I have a data template with multiple files associated to it, and trying to write a Deluge script that will fetch files associated with this data template. I created the script below based on the WorkDrive API documentation, one request uses the data templates

• ZOHO CRM User management or role

  I need guidance regarding Zoho CRM licensing and user management. I want to purchase one Zoho CRM license and create multiple team users under the same account with the following hierarchy: Super Admin User Manager User Executive Users (with limited access)

• Next Page