Maintaining accurate business details is critical for compliance and professional branding. While many settings are configured during setup, your integration may need to update organization-level information—such as the legal name, business address, or portal settings—programmatically.
At Kalki LLP, we ensure your business identity remains consistent across all your connected systems by automating these core configuration updates.
To modify an existing organization's details, you must perform a PUT request targeting the specific organization ID.
Endpoint: PUT /organizations/{organization_id}
While many fields can be modified, these are the most common ones managed via API:
| Parameter | Type | Description |
name | String | The legal name of your business. |
portal_name | String | The name displayed on the Client Portal. |
address | String | The primary business street address. |
city | String | The city where the business is registered. |
state | String | The state/province of the business. |
phone | String | The official business contact number. |
fax | String | The business fax number. |
website | String | The official company URL. |
When updating, you only need to include the fields you wish to change.
{
"name": "Kalki LLP Solutions Pvt Ltd",
"portal_name": "Kalki Client Hub",
"address": "Level 5, Tech Park",
"city": "Gurugram",
"state": "Haryana",
"website": "https://kalkillp.com"
}
Kalki LLP Pro-Tip: Certain fields like currency_id and fiscal_year_start_month are often locked after the first transaction is recorded. Always check the response code to verify if a field update was restricted.
In Zoho Deluge, you can use the invokeUrl task to update these settings. This is particularly useful for syncing your CRM's "Company Profile" with your Books "Organization" profile.
// Prepare the updated data map
updateData = Map();
updateData.put("name", "Kalki LLP - New Branch");
updateData.put("portal_name", "Kalki Global Portal");
// Execute the PUT request
response = invokeurl
[
url :"https://www.zohoapis.com/books/v3/organizations/" + orgID
type :PUT
parameters :updateData.toString()
connection :"kalki_connection"
];
if(response.get("code") == 0)
{
info "Organization updated successfully!";
}
else
{
info "Update failed: " + response.get("message");
}
If your update request fails, refer to these Zoho-specific logs to identify the cause:
| Error Code | Meaning | Fix for Kalki LLP Developers |
| 6024 | Invalid Organization ID | Ensure the ID in the URL is correct and you have access to it. |
| 57 | Invalid Access Token | Your session has expired. Refresh your OAuth token. |
| 1003 | Restricted Field | You are trying to update a field (like base currency) that is no longer editable. |
| 400 | JSON Format Error | Ensure your payload is valid JSON and strings are properly quoted. |
For our kalkillp.com clients, we often implement these updates to:
Sync Branding: Automatically update the Client Portal name when a company rebrands.
Update Contact Info: Ensure that if the head office address changes in your ERP, it instantly reflects on all outgoing Zoho Books invoices.
Regional Compliance: Programmatically update tax registration numbers when moving to a new state or region.
Manual updates lead to fragmented data and professional inconsistencies. Kalki LLP specializes in building robust sync engines that keep your Zoho Books organization profile perfectly aligned with your master business records.