Introduction
When updating Zoho CRM records using the ZappySys ODBC API Driver, you might encounter this error:
Code: RECORD_IN_BLUEPRINT
Message: Stage cannot be updated as it is in the blueprint
This happens when Zoho’s Blueprint automation restricts updates to certain fields unless specific transitions are followed.
Why this error occurs
Zoho CRM’s Blueprint feature enforces rules for transitioning between stages or statuses. When you try to update a record’s Stage
(or similar field) using ODBC/API, the update may fail if:
- The user lacks permission to override blueprint restrictions
- The record is currently in a locked blueprint stage
- The API call bypasses the designed workflow
How to fix it
Ask your Zoho CRM administrator to do the following:
- Grant full access to the target module (e.g. Deals)
- Enable edit permissions for locked fields like
Stage
,Quote_ID
, etc. - (Optional) Enable Blueprint override privileges for the API user
Once the correct privileges are set, retry your update. The error should disappear.
Best practice for using ODBC with Zoho CRM
- Use a dedicated Zoho user account for ODBC/API access
- Test updates on one record before applying them in bulk
- Log and monitor all updates to detect permission-related failures early
Need full details and examples?
For code samples, API behavior insights, and admin tips:
👉 Read the complete guide here
Top comments (0)