- Overview
- What's New in V3?
- Changelogs
- API Directory
- API Collection
- OAuth Authentication
- API Limits
- Multi DC Support
- Increase API Credits
- Customize API Usage Notification
- GDPR Compliance
- HIPAA Compliance
- API Dashboard
- Status Codes
- Request Methods
- Entity APIs
- Organization
- Users
- Roles
- Profiles
- Territories
- Records
- Records API using External ID
- Data Backup
- Meeting Cancel
- Subforms
- Linking Modules
- Related Records
- Related Records API using External ID
- Contact Roles
- Blueprint
- Variables
- Notes
- Scoring Rules
- Tags
- Photos and Attachments
- Mass Update
- Currencies
- Files
- Share
- Assignment Rules
- Pipeline
- Wizards
- Templates
- Fields Attachments
- Send Mail
- User's Unavailability
- Change Owner
- Metadata APIs
- Composite API
- Bulk APIs
- Notification APIs
- Query API
Wizards API
A Wizard helps you divide a long form into a series of screens, where users can enter data on each screen as they proceed to the next step until completion. Wizards reduce the chances of errors during data entry as the screens can be partially saved as a draft and submitted later. For more details, refer to Wizards in Zoho CRM.
Purpose
To get the details of the wizards in a module.
Request Details
Request URL
All wizards - {api-domain}/crm/{version}/settings/wizards
Layout-specific wizard - {api-domain}/crm/{version}/settings/wizards/{wizard_ID}?layout_id={layout_ID}
Supported modules
Leads, Contacts, Deals, Accounts, and custom
Header
Authorization: Zoho-oauthtoken <access_token>
Scope
Scope = ZohoCRM.settings.wizards.READ
Parameters
- layout_idstring, mandatory when you want to fetch a layout-specific wizard
The ID of the layout that you want to fetch the wizard's details from. Use the Layouts MetaData API to obtain the ID of the layout.
Sample Request to Get All Wizards in a Module
Copiedcurl "https://www.zohoapis.com/crm/v3/settings/wizards"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"Sample Response
Copied{
"wizards": [
{
"created_time": "2021-02-16T14:51:28+05:30",
"modified_time": "2022-03-22T06:18:30+05:30",
"module": {
"api_name": "Leads",
"id": "3652397000000002175"
},
"name": "wizard 2 leads",
"modified_by": {
"name": "Patricia Boyle",
"id": "3652397000000186017"
},
"profiles": [
{
"display_label": "Administrator",
"name": "Administrator",
"id": "3652397000000026011"
},
{
"display_label": "admin clone",
"name": "admin clone",
"id": "3652397000005787196"
}
],
"active": true,
"containers": [
{
"layout": {
"name": "Standard",
"id": "3652397000000091055"
},
"id": "3652397000000091055"
}
],
"id": "3652397000003875019",
"created_by": {
"name": "Patricia Boyle",
"id": "3652397000000186017"
}
},
{
"created_time": "2021-01-21T06:28:21+05:30",
"modified_time": "2021-01-21T06:28:21+05:30",
"module": {
"api_name": "Leads",
"id": "3652397000000002175"
},
"name": "wizard1",
"modified_by": {
"name": "Patricia Boyle",
"id": "3652397000000186017"
},
"profiles": [
{
"display_label": "Administrator",
"name": "Administrator",
"id": "3652397000000026011"
},
{
"display_label": "Standard",
"name": "Standard",
"id": "3652397000000026014"
},
{
"display_label": "Free",
"name": "Free",
"id": "3652397000001614008"
},
{
"display_label": "admin clone",
"name": "admin clone",
"id": "3652397000005787196"
}
],
"active": true,
"containers": [
{
"layout": {
"name": "Standard",
"id": "3652397000000091055"
},
"id": "3652397000000091055"
}
],
"id": "3652397000003677001",
"created_by": {
"name": "Patricia Boyle",
"id": "3652397000000186017"
}
},
{
"created_time": "2021-01-21T07:11:06+05:30",
"modified_time": "2021-01-21T07:11:06+05:30",
"module": {
"api_name": "Contacts",
"id": "3652397000000002179"
},
"name": "wizard2",
"modified_by": {
"name": "Patricia Boyle",
"id": "3652397000000186017"
},
"profiles": [
{
"display_label": "Administrator",
"name": "Administrator",
"id": "3652397000000026011"
},
{
"display_label": "admin clone",
"name": "admin clone",
"id": "3652397000005787196"
}
],
"active": true,
"containers": [
{
"layout": {
"name": "Standard",
"id": "3652397000000091033"
},
"id": "3652397000000091033"
}
],
"id": "3652397000003677031",
"created_by": {
"name": "Patricia Boyle",
"id": "3652397000000186017"
}
}
]
}
Show full
Show less
Possible Errors
- REQUIRED_PARAM_MISSINGHTTP 400
You have not specified the layout ID in the request.
Resolution: "layout_id" is a mandatory parameter when you want to fetch the details of a particular wizard in a module.
- OAUTH_SCOPE_MISMATCHHTTP 401
You do not have the scope required to use this API.
Resolution: Use the correct scope and generate the grant and access tokens to use this API. - NO_PERMISSIONHTTP 403
You do not have permission to use this API.
Resolution: Contact your administrator.
Sample Request to Get a Layout-specific Wizard
Copiedcurl "https://www.zohoapis.com/crm/v3/settings/wizards/3652397000003677001?layout_id=3652397000000091055"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"Sample Response
Copied{
"wizards": [
{
"created_time": "2021-02-16T14:51:28+05:30",
"modified_time": "2022-03-02T06:18:30+05:30",
"module": {
"api_name": "Leads",
"id": "3652397000000002175"
},
"name": "wizard 2 leads",
"modified_by": {
"name": "Patricia Boyle",
"id": "3652397000000186017"
},
"profiles": [
{
"display_label": "Administrator",
"name": "Administrator",
"id": "3652397000000026011"
},
{
"display_label": "admin clone",
"name": "admin clone",
"id": "3652397000005787196"
}
],
"active": true,
"containers": [
{
"layout": {
"name": "Standard",
"id": "3652397000000091055"
},
"chart_data": {
"nodes": [
{
"pos_y": 84,
"pos_x": 220,
"start_node": true,
"screen": {
"display_label": "Screen 1",
"id": "3652397000003875021"
}
},
{
"pos_y": 118,
"pos_x": 652,
"start_node": false,
"screen": {
"display_label": "Screen 2",
"id": "3652397000003875023"
}
}
],
"connections": [
{
"source_screen": {
"display_label": "Screen 1",
"id": "3652397000003875021"
},
"target_screen": {
"display_label": "Screen 2",
"id": "3652397000003875023"
},
"id": "3652397000003875063"
}
]
},
"screens": [
{
"display_label": "Screen 1",
"id": "3652397000003875021",
"conditional_rules": [
{
"query_id": "3652397000007463009",
"criteria": {
"comparator": "not_equal",
"field": {
"api_name": "Email",
"id": "3652397000000002599"
},
"value": "${EMPTY}"
},
"actions": [
{
"field": {
"api_name": "First_Name",
"id": "3652397000000002593"
},
"id": "3652397000007463019",
"type": "show_fields"
},
{
"field": {
"api_name": "First_Name",
"id": "3652397000000002593"
},
"id": "3652397000007463021",
"type": "set_mandatory"
},
{
"segment": {
"display_label": "Subform 2",
"id": "3652397000007463003"
},
"id": "3652397000007463023",
"type": "show_subforms"
}
]
}
],
"segments": [
{
"sequence_number": 1,
"display_label": "Segment Title",
"column_count": 2,
"id": "3652397000003875025",
"type": "fields",
"fields": [
{
"sequence_number": 1,
"api_name": "Last_Name",
"id": "3652397000000002595"
},
{
"sequence_number": 3,
"api_name": "First_Name",
"id": "3652397000000002593"
},
{
"sequence_number": 3,
"api_name": "Salutation",
"id": "3652397000000022011"
},
{
"sequence_number": 5,
"api_name": "Email",
"id": "3652397000000002599"
}
]
},
{
"sequence_number": 2,
"display_label": "Subform 2",
"column_count": 2,
"id": "3652397000007463003",
"type": "subforms",
"fields": [
{
"id": "3652397000000701093"
}
]
},
{
"sequence_number": 3,
"display_label": "Dummy",
"buttons": [
{
"color": "#fff",
"shape": "square",
"visibility": "show",
"resource": null,
"criteria": null,
"target_screen": {
"name": "Screen 2",
"id": "3652397000003875023"
},
"type": "transition",
"transition": null,
"display_label": "Next",
"sequence_number": 1,
"background_color": "#1161B5",
"id": "3652397000003875035",
"category": "wizard_button"
}
],
"column_count": 2,
"id": "3652397000003875037",
"type": "buttons"
}
]
},
{
"display_label": "Screen 2",
"id": "3652397000003875023",
"segments": [
{
"sequence_number": 1,
"display_label": "Segment Title",
"column_count": 2,
"id": "3652397000003875045",
"type": "fields",
"fields": [
{
"sequence_number": 1,
"api_name": "Owner",
"id": "3652397000000002589"
},
{
"sequence_number": 3,
"api_name": "Lead_Status",
"id": "3652397000000002611"
}
]
},
{
"sequence_number": 2,
"display_label": "Dummy",
"buttons": [
{
"color": "#fff",
"shape": "square",
"visibility": "show",
"resource": null,
"criteria": null,
"target_screen": null,
"type": "save",
"message": {
"title": "Acknowledgement Title",
"content": "Acknowledgement Content"
},
"transition": null,
"display_label": "Save",
"sequence_number": 1,
"background_color": "#1161B5",
"id": "3652397000003875053",
"category": "wizard_button"
}
],
"column_count": 2,
"id": "3652397000003875055",
"type": "buttons"
}
]
}
],
"id": "3652397000000091055"
}
],
"id": "3652397000003875019",
"created_by": {
"name": "Patricia Boyle",
"id": "3652397000000186017"
}
}
]
}Show full
Show less
© 2025, Zoho Corporation Pvt. Ltd. All Rights Reserved.