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

• 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

• 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]

• 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

• 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

• 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

• ¿Puedo migrar mi sitio desde WordPress a Zoho? ¿Zoho admite herramientas con código personalizado?

  ¡Hola comunidad! Estoy evaluando la posibilidad de migrar mi sitio web https://calculadoradenotas.cl/ desde WordPress a una solución Zoho, y tengo algunas dudas técnicas que espero puedan aclararme. Mi sitio no es solo informativo: es una herramienta

• Make Task ID and Issue ID columns filterable like all other columns

  Hello Zoho Projects Team, We hope you are doing well. We would like to submit a feature request regarding the Task ID and Issue ID columns in Zoho Projects list views. Current Limitation: As of now, in both the Tasks and Issues modules, almost every visible

• Improve Back Navigation (X Button) Inside Nested Milestones, Task Lists, Tasks, and Issues

  Hi Zoho Projects Team, We would like to request an improvement to the X / close button navigation behavior inside milestones. Currently, the milestone area behaves as a nested hierarchy (tree structure): Project → Milestone → Task List → Task So when

• Add a way to connect Log360 Cloud logs with Zoho analytics

  Hi, Several month ago Log360 Cloud was added to zoho one - and this is great. But as far as I see there is no prebuilt way to connect Zoho analytics to the logs we have in Log360 Cloud. Please add a prebuilt connection like we have for so many other zoho

• Extend GitHub Commit Integration to Tasks in Zoho Projects

  Hello Zoho Projects Team, We hope you are doing well. We would like to submit a feature request regarding the current GitHub integration in Zoho Projects, specifically the ability to link commit information. Current Limitation: As of now, Zoho Projects

• Enable Screen Recording in Zoho WorkDrive Mobile Apps (Android & iOS)

  Hi Zoho WorkDrive Team, How are you? We are enthusiastic Zoho One users and rely heavily on Zoho WorkDrive for internal collaboration and content sharing. The screen-recording feature in the WorkDrive web app (similar to Loom) is extremely useful- however,

• Zoho Project - Total Forecasted Hours

  Does anyone know an easy way to get a total of all the forecasted hours across the portfolio? I'm aware trying to create a custom report that can generate this figure for each task and the total up but the completion percentage doesn't seem to come back

• Bank Fees - Allow User to Choose Expense Account

  Bank fees from Customer Payments can only be debited against the system Bank Fees account due to hard-coding. The user should be able to select which expense account those fees are debited against. The use case is pretty straightforward. A business like

• Attendance Kiosk Mode for all Employees

  Is it possible to assign a tablet (ios/android) so that all employees can check in or out using a simple QR code? If not would it be possible to integrate attendance with a web app that also has a tablet app that works in kiosk mode? If yes can anyone recommend such an app?

• How can we get payment status updates for payment links in Zoho Books using webhooks?

  When we create and share a payment link in Zoho Books, is there a way to know when the payment is updated? Can we use webhooks to get real-time updates for payment link status instead of checking manually?

• Update to CRM Custom Buttons: Collect Users' Location

  Hello everyone! Buttons in Zoho CRM allow you to extend the default CRM capabilities for your bespoke business needs. It provides the flexibility to connect to any third-party application to perform necessary actions. Wouldn't it be better, if those buttons

• 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

• CRM x WorkDrive: We're rolling out the WorkDrive-powered file storage experience for existing users

  Release plan: Gradual rollout to customers without file storage add-ons, in this order: 1. Standalone CRM 2. CRM Plus and Zoho One DCs: All | Editions: All Available now for: - Standalone CRM accounts in Free and Standard editions without file storage

• Challenges with data consistency when integrating Zoho with other systems

  In setups where Zoho (CRM/Inventory) is connected with external systems like eCommerce platforms, maintaining consistent and reliable data across systems can be challenging. Some common issues that tend to come up: Product data mismatches (variants, pricing

• 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

• Announcing Zoho Sheet desktop app for macOS and Windows (Beta)

  Hello Sheet users, We know you’ve been waiting for this one. It has always been the top priority on our roadmap to provide a single native desktop app for macOS and Windows that works both online and offline. Today, we are excited to announce that the

• Zoho Mail Android app update: UI revamp

  Hello everyone! We are excited to share that the first phase of the Zoho Mail Android UI revamp is now live. In this update, we have redesigned navigation bar at the bottom to quickly access the Email, Calendar, Contacts, and Settings modules. Also, the

• Records Per Page

  Can we get max number of records per page increased from 100 to 250 and 500 please? Or alternatively allow us to use the Zoho Sheet View for all records and not just the max 100 showing on the page? thanks.

• This campain is on hold

  Trying to start a Zoho Campaign for our company but the error message when we try to send it out it this: This campaign is on hold Our compliance team needs additional information about your sender domain address. They'll reach out to you shortly via

• Blueprint transitions on locked records

  We use the ability to automatically lock records (quotes, sales orders, etc.) based on criteria, such as stage. For instance, if a quote has been sent to a client, the quote is then locked for further edits. Our ideal quote stage process is: Draft>Sent>Won.

• Whatsapp Limitation Questions

  Good day, I would like to find out about the functionality or possibility of all the below points within the Zoho/WhatsApp integration. Will WhatsApp buttons ever be possible in the future? Will WhatsApp Re-directs to different users be possible based

• Sales Ordes removes TAX at random for some or all prodcuts, even after creating it

  Hi at Zoho CRM, in the Sales Orders section, when Creating, Cloning or editing any Sales Orders the TAX of one or all products gets "unchecked" at random. All of our products ALWAYS must have the same TAX selected automatically. At least it used to be

• Turning off self view in Zoho Meeting

  Hi Is it possible to turn off/hide self view in meetings?  Cant see any options for it. Thanks

• 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.

• Please add Deluge code editing for Forms

  Assuming Forms is built on the same codebase as Creator, etc., it would be wonderful to be able to edit form code, cut and paste form elements across different forms, share code with other users, and so on.

• Is there any workaround or method to restrict user login to a particular device

  Hi, I want to restrict my CRM user from accessing the Zoho CRM/Zoho One application to the company provided devices only. As far as I have explored there is no direct way to do this. Is there any workarounds that will allow me to do this. I want to ensure

• Email from CRM being Blocked or Marked as Spam by Google (and maybe more)

  In the past 24 hours we’ve noticed that emails sent via Zoho CRM are being blocked or flagged as phishing, particularly by Google. The issue seems to occur specifically when emails contain links. URLs like www.domain.com or www.example.com are automatically

• All new Address Field in Zoho CRM: maintain structured and accurate address inputs

  Availability Update: 29 September 2025: It's currently available for all new sign-ups and for existing Zoho CRM orgs which are in the Professional edition exclusively for IN DC users. 2 March 2026: Available to users in all DCs except US and EU DC. 24

• Zoho Tables - Form default entry

  How so I set a form field to be populated with an entry from another table? I created a view on my source table limiting the results to just the one thing I want to see. When adding a Client via my Add Client form, I want the Client Type field to already

• Payment Card or Identity form-fill from Vault?

  Hello! I'm working on replacing Bitwarden with Vault and one issue I've run into is that I can't find any option to fill address and payment forms from Payment Card or Identity info that has been saved in Vault. Is there a way to do this? Is it a planned

• Introducing Bin Locations In Zoho Inventory

  Hello users, We are excited to let you know that your wait for the Bin Locations feature has now come to an end! Yes, you heard us right! We are here to introduce the much-awaited Bin Locations now in Zoho Inventory. But before we dive into the feature

• Add Actionable “Smart Commits” for GitHub Integration

  Hi Zoho Projects Team, I am submitting a feature request to introduce Smart Commits support for the GitHub integration in Zoho Projects. The Current Limitation: Currently, Zoho Projects offers a "passive" integration. Including a Task ID in a commit message

• Item Details Field - New Barcode / Document option?

  Is this a new feature??? its in both books and inventory.

• Next Page