Zoho Books API v3: Marking a Contact as Active

When a contact is inactive in Zoho Books, they are hidden from the primary list and cannot be selected for new Invoices, Sales Orders, or Bills. The Mark as Active API is a specific "action" endpoint that restores the contact's visibility and usability across the organization.

At Kalki LLP, we recommend using this specific action endpoint rather than a general PUT update, as it triggers the necessary background validation required to re-enable the contact.

1. The Action Request (POST)

To activate a contact, you must perform a POST request to the specialized /active sub-resource.

Endpoint: POST /contacts/{contact_id}/active?organization_id={organization_id}

Request Requirements:

• Method: POST (Even though no body is required, the method must be POST).

• URL: Requires the unique contact_id.

• Body: Empty (No JSON payload is needed).

2. API Response

A successful activation will return a code: 0 and a success message.

Sample JSON Response:

{
    "code": 0,
    "message": "The contact has been marked as active."
}

3. Implementation in Deluge (Kalki LLP Automation)

This is a common requirement in "Sync" scripts—for example, if a customer who was previously deactivated in your CRM becomes an "Active" lead again.

// Define the Contact ID to activate
contactID = "460000000026049";
orgID = "123456789";

// Construct the URL
urlPath = "https://www.zohoapis.in/books/v3/contacts/" + contactID + "/active?organization_id=" + orgID;

// Execute the POST request
response = invokeurl
[
	url :urlPath
	type :POST
	connection :"kalki_connection"
];

if(response.get("code") == 0)
{
    info "Kalki Success: Customer " + contactID + " is now active in Zoho Books.";
}
else
{
    info "Activation failed: " + response.get("message");
}

4. Error Logs & Troubleshooting

5. Why Use "Active/Inactive" Instead of Deleting?

For kalkillp.com clients, we always suggest deactivating instead of deleting for two reasons:

1. Audit Trail: Deleting a contact with existing transactions is restricted in Zoho Books. Making them inactive preserves the financial history while cleaning up the UI.

2. API Performance: It is much faster to "toggle" a status via this endpoint than to manage the lifecycle of deleting and recreating records.

Streamline Your Contact Lifecycle

Manual status updates can lead to billing delays and "missing" customer records. Kalki LLP can help you automate the active/inactive status of your vendors and customers based on their real-time engagement in your CRM or external platforms.