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

• Super Admin Logging in as another User

  How can a Super Admin login as another user. For example, I have a sales rep that is having issues with their Accounts and I want to view their Zoho Account with out having to do a GTM and sharing screens. Moderation Update (8th Aug 2025): We are working

• Sync Enable issue Between Zoho FSM and Invoice

  Hello Latha, I hope you are doing well. I am trying to enable synchronization between Zoho FSM (Org ID: 170000078905) and Zoho Invoice (Org ID: 170000079301). However, when I attempt to do so, I receive an “Internal error” message. Could you please assist

• Check out in Meetings

  Why there is no check out in Meetings of Zoho CRM, very difficult to track

• WO Completion Status Not Updating Automatically

  Hello Latha, Hope you are doing well. Over the past few days, we have been facing an issue with WO completion. When an AP is marked as complete, the work order status is not automatically updating to “Completed,” and we have to mark it manually. Could

• Query on Tracking Visitor Activity with Zoho Forms & SalesIQ

  I have a query regarding Zoho Forms, Zoho SalesIQ, and Zoho CRM. I have embedded a Zoho Forms form on my website, and I’m trying to understand if it’s possible to capture a user’s website activity (such as pages visited, visit count, etc.) when they submit

• Canvas templates can now be shared with different CRM organizations

  ----------------------------------------Moderated on 14th February, 2023------------------------------------------- Dear all, This feature is now open for all users in all DCs. To learn more about importing and exporting canvas templates, read our help

• CRM to Desk Contact Sync Issues?

  Hello, I noticed none of the contact changes in CRM are being transferred over to Desk. Anyone else experiencing this? I checked the sync history in desk and it confirms it - it doesn't show "X Contacts Synced" like it normally does.

• Microsoft Teams integration in Zoho Apptics

  Good app monitoring is not just about collecting data. It is about making sure important updates reach the team in time to act on them. When an app crashes or a user shares feedback from within the app, teams should be able to see it promptly without

• Able to change project on timelog entries

  Ability to move the timesheet entry from one project to another. When a user adds a wrong entry a manager can change/update the timesheet entry to the correct project.

• Marketing Tip #28: Increase buyer confidence with visible social media links

  Your social media pages are often where customers go to “double-check” your brand before buying. When visitors can easily find your Instagram, Facebook, YouTube, or LinkedIn from your store, it builds trust and makes your business feel more real and active.

• [Webinar] Solving business challenges: One tool for documents, forms, PDFs, e-signatures, and more

  Hi Zoho Writer users, Most businesses rely on multiple tools, such as a word processor, form builder, e-signature provider, and PDF editor, for their document workflows. Managing multiple subscriptions, switching between tools, and moving data across

• Customer Message Edit/Delete Function & Backend Visibility Inquiry

  目前客服已发送的对话支持编辑和删除功能，请问在 Zoho 系统后台，是否可以查看客服具体发送了什么内容，以及删除或修改了哪些信息？如果无法查看，这个功能是否可以通过设置关闭客服的编辑和删除权限？如可以，请告知具体设置路径。 Currently, customer service agents are able to edit and delete messages after sending them. In the Zoho system backend, is it possible to view

• Google Drive API 403 PERMISSION_DENIED from Deluge custom function - OAuth connection not recognised

  Hi all, I've built a custom Deluge function to route Zoho CRM Account attachments into specific Google Drive subfolders based on filename prefix. The CRM API steps all work correctly, however our first Google Drive API call (listing subfolders via drive/v3/files)

• Supercharge Your Zoho Billing Workflows with AI Using Zoho MCP

  What is MCP and how does it connect to Zoho Billing? If you've ever wished you could just tell your billing software what to do without clicking through menus, running reports manually, or switching tabs every five minutes, that's exactly what the Zoho

• What's new in Zoho Social - Q1 recap

  Hello everyone, We’ve rolled out a bunch of updates in Q1, and we’re excited to walk you through them. To help you explore these features in detail, we’re hosting a Q1 recap webinar where we’ll show you how to make the most of each update. Q1 recap webinar

• Introducing Auto-trigger for Screening Bot

  Still manually sending screening tests after every application? Not anymore. With Auto-trigger for Screening Bot, screening now begins automatically. When a candidate applies for a job that has an attached assessment, Recruit checks whether the test has

• Trying to validate user's age through DoB

  We have a form where a user enters their birthdate. We'd like a rule that counts whether the user is over or under 25 years of age. This amounts to 9125 days elapsed between today and an easy way to do this would be to use conditional rule Is Before [x]

• Automation Series: Notify Admin When User Accepts an Invitation

  In Zoho Projects, a portal is an organisational-level workspace where user can manage multiple projects. To join a portal, a user will have to accept the portal invitation. However, it is important for admins to be in the loop when a user accepts the

• Introducing SlyteUI : From Idea to a Working Interface in Minutes

  Hello everyone! Are you spending hours building basic UIs? Does even the smallest customization feel like a major task? CRM customization should feel intuitive and straightforward, not time consuming or exhausting. SlyteUI makes this possible by simplifying

• Api Version 2 Refresh Token invalid_code

  While Refresh token i am always getting Error {     "error": "invalid_code" } i am trying to pass all parameter as per this https://www.zoho.com/crm/developer/docs/api/refresh.html still non of things working any one have idea whats the reason for same ... please help due to this i stuck since last one week

• Knowledgebase SEO

  We have a custom-domain mapped help center that is not restricted via login. I have some questions: a) will a robots.txt file still allow us to control indexing? b) do we have the ability to edit the sitemap? c) do category URLs get indexed by search

• Mail Merge preview won't load

  Hello! One of our users has not been able to use mail merge templates in CRM as the preview screen does not load. We have many templates for one of our custom modules and the users are used to this feature and have been using it for years without any

• mask Customer phone number and agents cant see customer phone number

  Is there any way we can integrate Zoom Phone with Zoho CRM while ensuring that customer phone numbers remain masked? We need a solution where agents can make outbound calls but cannot see customer phone numbers. Please let us know if there is any solution

• Issue with Zoho Sheets

  Edit: Small Error of Opening doc and losing entire formatting while downloading to *.xlsx format. Also my formulas don't work while opening a document downloaded from Zoho sheets, since the colors aren't matched to the correct data. Even though the data

• Record-Level Cliq Conversations Inside Zoho CRM

  It would be extremely useful to bring the Zoho Projects + Cliq conversation experience into Zoho CRM records. Today, in Zoho Projects, each project or task can have its own related chat conversation through Cliq, allowing team members to discuss that

• Introducing note actions and dynamic visibility in Kiosk Studio

  Hello all, We are introducing enhancements to Kiosk Studio that will improve the product scope and meet your custom needs more precisely. What's new? Add notes as Actions: You can add notes to CRM records as kiosk Actions, as well as insert merge fields

• Logging Calls not working

  For some reason, logging calls is not working anymore. Description of problem: On a Lead's record, in the "Open Activities" block, clicked on "Add New" Clicked on "Call", clicked on "Log a call" Nothing happens. If I click on "Schedule a call" nothings

• How do I filter contacts by account parameters?

  Need to filter a contact view according to account parameter, eg account type. Without this filter users are overwhelmed with irrelevant contacts. Workaround is to create a custom 'Contact Type' field but this unbearable duplicity as the information already

• Data Import into Zoho Forms

  Hi everyone, I am migrating several Google Forms into Zoho Forms. I can recreate the forms, but I also need to bring over historical response data currently stored in Google Sheets. I want to keep using that data inside Zoho for analysis, reporting, and

• Best practice to handle 50+ invokeurl calls in a loop without hitting the 30-second timeout?

  Hi everyone, I am working on a custom Deluge function where I have a Map containing around 50+ key-value pairs. I need to iterate through this Map using a for each loop and make a GET API call (invokeurl) for each item. The Problem: Because of the 50+

• How Can I Clear Deleted Members and Free Up Their Storage?

  Can we remove these deleted members and free up their storage?

• Cliq iOS can't see shared screen

  Hello, I had this morning a video call with a colleague. She is using Cliq Desktop MacOS and wanted to share her screen with me. I'm on iPad. I noticed, while she shared her screen, I could only see her video, but not the shared screen... Does Cliq iOS is able to display shared screen, or is it somewhere else to be found ? Regards

• Zoho Desk - Event Calendar View

  Hi Desk team, Are there any plans to introduce a calendar or timeline view for Events in Zoho Desk? It would be very helpful if we could see Events visually in a calendar and/or timeline. This is very helpful when desk side support activities need to

• Pro rata holiday allowance for variable part time employees

  We have some part time staff who work variable hours and their holiday allowance is based on pro rata system. In Zoho people is there any way to calculate their holiday allowance based on actual hours worked? I.e. worker is entitled to a pro-rata amount of 5.6 weeks holiday, which is equivalent to 12.07% of hours worked over a year. So part time staff's holiday is accrued at a rate of 12.07% per hour worked. Thanks

• Zoho Bookings - Provide Appointment System ID in Zoho Flow Variable

  Hi Bookings Team, It would be great if you could provide the system record ID for appointments as a variable in Zoho Flow trigger outputs and Fetch Appointments action. This would allow us to create a dymanic URL which can be clicked by a staff user to

• Invoice date is incorrect

  I'm trying to pull a report of Sales Orders and filter by Invoice Date. (ex: all of 2025) Unfortunately, the filter still returns lots of SO's from other years including 2026 which would be impossible to have an invoice in 2025 from a 2026 order. It's

• Zoho Forms sheet prefil

  I've been using zoho sheet prefill for a week and it was working perfectly, as soon as i deleted the particular sheet and replaced it with another one no matter what I do it cant find the record and i get this message. Could you please assist me to resolve

• Understanding tasks

  So we have a module linked to contacts called Equipment and that in turn has a related module called service calls. Often on a service call we want add a task but we are not able. I think it needs a link to the contact. WE therefore tried to add tasks

• How to transfer files from Creator file upload fields to CRM file upload fields

  This article describes how to transfer files from Zoho Creator file upload fields to Zoho CRM file upload fields. I'm posting it here because the current documentation does not fully and accurately describe how to do this with certain file types (PDF,

• Add Comprehensive Accessibility Features to Zoho Writer

  Hello Zoho Writer Team, We hope you are doing well. We would like to submit a feature request to enhance Zoho Writer with a full set of accessibility tools, similar to the accessibility options already available in the Zoho Desk agent interface. 🚧 Current

• Next Page