Categories
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Categories are hierarchical groupings used to organize items.
Download Categories OpenAPI Document
End Points
Create a category
List categories
Update a category
Retrieve a category
Delete a category
Attribute
category_id
string
Unique identifier of the category. Note: This value is a set of numeric characters.
name
string
Name of the category.
description
string
Description of the category.
url
string
URL slug for the category.
parent_category_id
string
Unique identifier of the parent category. Use
-1 for the root category. Note: This value is a set of numeric characters. visibility
boolean
Whether the category is visible. Allowed values
true and false. seo_title
string
SEO title for the category page.
seo_keyword
string
SEO keywords for the category page.
seo_description
string
SEO description for the category page.
sibling_order
integer
Display order of the category among its siblings.
ondc_category_type
string
ONDC category type associated with the category.
category_tax_preferences
array
🇮🇳
India
only
Tax preferences associated with the category.
tax_specification
string
🇮🇳
India
only
Tax specification. Allowed Values:
intra, inter. tax_id
string
🇮🇳
India
only
Unique identifier of the tax. Note: This value is a set of numeric characters.
custom_fields
array
Custom fields associated with the category.
index
integer
Index of the custom field.
value
string
Value of the custom field.
ancestors
array
Ancestor categories in the hierarchy.
category_id
string
Unique identifier of the category. Note: This value is a set of numeric characters.
name
string
Name of the category.
url
string
URL slug for the category.
parent_category_id
string
Unique identifier of the parent category. Use
-1 for the root category. Note: This value is a set of numeric characters. visibility
boolean
Whether the category is visible. Allowed values
true and false. children
array
Child categories of the category.
category_id
string
Unique identifier of the category. Note: This value is a set of numeric characters.
name
string
Name of the category.
url
string
URL slug for the category.
parent_category_id
string
Unique identifier of the parent category. Use
-1 for the root category. Note: This value is a set of numeric characters. visibility
boolean
Whether the category is visible. Allowed values
true and false. products
array
Items associated with the category.
{
"category_id": "460000000038080",
"name": "Gadgets",
"description": "Electronic gadgets and accessories",
"url": "gadgets",
"parent_category_id": "-1",
"parent_category_name": "ROOT",
"visibility": true,
"show_in_menu": true,
"seo_title": "Gadgets",
"seo_keyword": "gadgets, electronics",
"seo_description": "Shop gadgets and electronics",
"sibling_order": 1,
"depth": 0,
"has_active_items": true,
"ondc_category_type": "",
"is_deprecated_ondc_category": false,
"created_time": "2025-07-18T09:24:08+0530",
"last_modified_time": "2025-07-18T09:24:09+0530",
"category_tax_preferences": [
{
"tax_specification": "intra",
"tax_id": "982000000037049"
}
],
"custom_fields": [
{
"index": 1,
"value": "Premium"
}
],
"ancestors": [
{
"category_id": "460000000038080",
"name": "Gadgets",
"url": "gadgets",
"parent_category_id": "-1",
"visibility": true,
"show_in_menu": true,
"created_time": "2025-07-18T09:24:08+0530",
"last_modified_time": "2025-07-18T09:24:09+0530"
}
],
"children": [
{
"category_id": "460000000038080",
"name": "Gadgets",
"url": "gadgets",
"parent_category_id": "-1",
"visibility": true,
"show_in_menu": true,
"created_time": "2025-07-18T09:24:08+0530",
"last_modified_time": "2025-07-18T09:24:09+0530"
}
],
"products": [
{}
]
}
Create a category
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Create a new category.
OAuth Scope : ERP.categories.CREATE
Arguments
name
string
(Required)
Name of the category.
url
string
(Required)
URL slug for the category.
description
string
Description of the category.
parent_category_id
string
Unique identifier of the parent category. Use
-1 for the root category. Note: This value is a set of numeric characters. sibling_order
integer
Display order of the category among its siblings.
visibility
boolean
Whether the category is visible. Allowed values
true and false. category_tax_preferences
array
🇮🇳
India
only
Tax preferences associated with the category.
tax_specification
string
🇮🇳
India
only
Tax specification. Allowed Values:
intra, inter. tax_id
string
🇮🇳
India
only
Unique identifier of the tax. Note: This value is a set of numeric characters.
custom_fields
array
Custom fields associated with the category.
index
integer
Index of the custom field.
value
string
Value of the custom field.
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
parameters_data='{"field1":"value1","field2":"value2"}';
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/categories?organization_id=10234695"
type: POST
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/categories?organization_id=10234695")
.post(body)
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.addHeader("content-type", "application/json")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'POST',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
'content-type': 'application/json'
},
body: '{"field1":"value1","field2":"value2"}'
};
fetch('https://www.zohoapis.in/erp/v3/categories?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"
headers = {
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
'content-type': "application/json"
}
conn.request("POST", "/erp/v3/categories?organization_id=10234695", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "POST",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/categories?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
"content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.write(JSON.stringify({field1: 'value1', field2: 'value2'}));
req.end();
curl --request POST \
--url 'https://www.zohoapis.in/erp/v3/categories?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
--header 'content-type: application/json' \
--data '{"field1":"value1","field2":"value2"}'
{
"name": "Gadgets",
"url": "gadgets",
"description": "Electronic gadgets and accessories",
"parent_category_id": "-1",
"sibling_order": 1,
"visibility": true,
"show_in_menu": true,
"category_tax_preferences": [
{
"tax_specification": "intra",
"tax_id": "982000000037049"
}
],
"custom_fields": [
{
"index": 1,
"value": "Premium"
}
]
}
{
"code": 0,
"message": "Category added successfully",
"category": {
"category_id": "460000000038080",
"name": "Gadgets",
"description": "Electronic gadgets and accessories",
"url": "gadgets",
"parent_category_id": "-1",
"parent_category_name": "ROOT",
"visibility": true,
"show_in_menu": true,
"seo_title": "Gadgets",
"seo_keyword": "gadgets, electronics",
"seo_description": "Shop gadgets and electronics",
"sibling_order": 1,
"depth": 0,
"has_active_items": true,
"ondc_category_type": "",
"is_deprecated_ondc_category": false,
"created_time": "2025-07-18T09:24:08+0530",
"last_modified_time": "2025-07-18T09:24:09+0530",
"category_tax_preferences": [
{
"tax_specification": "intra",
"tax_id": "982000000037049"
}
],
"custom_fields": [
{
"index": 1,
"value": "Premium"
}
],
"ancestors": [
{
"category_id": "460000000038080",
"name": "Gadgets",
"url": "gadgets",
"parent_category_id": "-1",
"visibility": true,
"show_in_menu": true,
"created_time": "2025-07-18T09:24:08+0530",
"last_modified_time": "2025-07-18T09:24:09+0530"
}
],
"children": [
{
"category_id": "460000000038080",
"name": "Gadgets",
"url": "gadgets",
"parent_category_id": "-1",
"visibility": true,
"show_in_menu": true,
"created_time": "2025-07-18T09:24:08+0530",
"last_modified_time": "2025-07-18T09:24:09+0530"
}
],
"products": [
{...}
]
}
}
List categories
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
List categories with pagination, filters, and search. Results are returned as a hierarchical list unless filtered by purchase group.
OAuth Scope : ERP.categories.READ
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
parent_category_id
string
Filter categories that are children of the specified parent category. Use
-1 for the root category. include_parent_category
boolean
If true, the parent category is included in the results when filtering by parent_category_id. Default value is true.
include_root_category
boolean
If true, includes the root category in the hierarchical list. Default value is true.
last_modified_time
string
Filter categories modified on or after the specified timestamp. Format:
yyyy-MM-dd'T'HH:mm:ssZ. filter_by
string
Filter categories by type. Allowed Values:
Type.All, Type.ShowInMenu, Type.ActiveItems. Default value is Type.All. search_text
string
Search categories by name or description.
name
string
Search categories by name. Variants:
name_startswith, name_contains, name_in, name_not_in. category_ids
string
Comma-separated list of category IDs to filter the results. Note: This value is a set of numeric characters.
created_time
string
Filter by creation time. Variants:
created_time_less_than, created_time_less_equals, created_time_greater_than, and created_time_greater_equals. Format: yyyy-MM-ddTHH:mm:ssZ. purchase_group_id
string
Filter categories mapped to the specified purchase group. Returns a flat list of mapped categories. Note: This value is a set of numeric characters.
page
integer
Page number to be fetched. Default value is 1.
per_page
integer
Number of records to be fetched per page. Default value is 5000.
sort_column
string
Column by which the results are sorted. Default value is
sibling_order. sort_order
string
Sort order. Allowed Values:
A (ascending), D (descending). Default value is A.headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/categories?organization_id=10234695"
type: GET
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/categories?organization_id=10234695")
.get()
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'GET',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://www.zohoapis.in/erp/v3/categories?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("GET", "/erp/v3/categories?organization_id=10234695", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "GET",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/categories?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request GET \
--url 'https://www.zohoapis.in/erp/v3/categories?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"code": 0,
"message": "success",
"categories": [
{
"category_id": "460000000038080",
"name": "Gadgets",
"description": "Electronic gadgets and accessories",
"url": "gadgets",
"parent_category_id": "-1",
"visibility": true,
"show_in_menu": true,
"sibling_order": 1,
"depth": 0,
"has_active_items": true,
"ondc_category_type": "",
"custom_fields": [
{
"index": 1,
"value": "Premium"
}
],
"created_time": "2025-07-18T09:24:08+0530",
"last_modified_time": "2025-07-18T09:24:09+0530"
},
{...},
{...}
],
"page_context": {
"page": 1,
"per_page": 5000,
"has_more_page": false,
"report_name": "zos.dashboard.categories",
"applied_filter": "Type.All",
"sort_column": "sibling_order",
"sort_order": "A"
}
}
Update a category
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Update details of an existing category.
OAuth Scope : ERP.categories.UPDATE
Path Parameters
category_id
string
(Required)
Unique identifier of the category. Note: This value is a set of numeric characters.
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
update_all_items
boolean
If
true, applies applicable category updates to all items under the category.parameters_data='{"field1":"value1","field2":"value2"}';
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/categories/460000000038080?organization_id=10234695"
type: PUT
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/categories/460000000038080?organization_id=10234695")
.put(body)
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.addHeader("content-type", "application/json")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'PUT',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
'content-type': 'application/json'
},
body: '{"field1":"value1","field2":"value2"}'
};
fetch('https://www.zohoapis.in/erp/v3/categories/460000000038080?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"
headers = {
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
'content-type': "application/json"
}
conn.request("PUT", "/erp/v3/categories/460000000038080?organization_id=10234695", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "PUT",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/categories/460000000038080?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
"content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.write(JSON.stringify({field1: 'value1', field2: 'value2'}));
req.end();
curl --request PUT \
--url 'https://www.zohoapis.in/erp/v3/categories/460000000038080?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
--header 'content-type: application/json' \
--data '{"field1":"value1","field2":"value2"}'
{
"name": "Gadgets",
"url": "gadgets",
"description": "Electronic gadgets and accessories",
"parent_category_id": "-1",
"sibling_order": 1,
"visibility": true,
"show_in_menu": true,
"category_tax_preferences": [
{
"tax_specification": "intra",
"tax_id": "982000000037049"
}
],
"custom_fields": [
{
"index": 1,
"value": "Premium"
}
]
}
{
"code": 0,
"message": "Category details updated successfully",
"category": {
"category_id": "460000000038080",
"name": "Gadgets",
"description": "Electronic gadgets and accessories",
"url": "gadgets",
"parent_category_id": "-1",
"parent_category_name": "ROOT",
"visibility": true,
"show_in_menu": true,
"seo_title": "Gadgets",
"seo_keyword": "gadgets, electronics",
"seo_description": "Shop gadgets and electronics",
"sibling_order": 1,
"depth": 0,
"has_active_items": true,
"ondc_category_type": "",
"is_deprecated_ondc_category": false,
"created_time": "2025-07-18T09:24:08+0530",
"last_modified_time": "2025-07-18T09:24:09+0530",
"category_tax_preferences": [
{
"tax_specification": "intra",
"tax_id": "982000000037049"
}
],
"custom_fields": [
{
"index": 1,
"value": "Premium"
}
],
"ancestors": [
{
"category_id": "460000000038080",
"name": "Gadgets",
"url": "gadgets",
"parent_category_id": "-1",
"visibility": true,
"show_in_menu": true,
"created_time": "2025-07-18T09:24:08+0530",
"last_modified_time": "2025-07-18T09:24:09+0530"
}
],
"children": [
{
"category_id": "460000000038080",
"name": "Gadgets",
"url": "gadgets",
"parent_category_id": "-1",
"visibility": true,
"show_in_menu": true,
"created_time": "2025-07-18T09:24:08+0530",
"last_modified_time": "2025-07-18T09:24:09+0530"
}
],
"products": [
{...}
]
}
}
Retrieve a category
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Details of an existing category, including ancestors and children.
OAuth Scope : ERP.categories.READ
Path Parameters
category_id
string
(Required)
Unique identifier of the category. Note: This value is a set of numeric characters.
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/categories/460000000038080?organization_id=10234695"
type: GET
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/categories/460000000038080?organization_id=10234695")
.get()
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'GET',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://www.zohoapis.in/erp/v3/categories/460000000038080?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("GET", "/erp/v3/categories/460000000038080?organization_id=10234695", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "GET",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/categories/460000000038080?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request GET \
--url 'https://www.zohoapis.in/erp/v3/categories/460000000038080?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"code": 0,
"message": "success",
"category": {
"category_id": "460000000038080",
"name": "Gadgets",
"description": "Electronic gadgets and accessories",
"url": "gadgets",
"parent_category_id": "-1",
"parent_category_name": "ROOT",
"visibility": true,
"show_in_menu": true,
"seo_title": "Gadgets",
"seo_keyword": "gadgets, electronics",
"seo_description": "Shop gadgets and electronics",
"sibling_order": 1,
"depth": 0,
"has_active_items": true,
"ondc_category_type": "",
"is_deprecated_ondc_category": false,
"created_time": "2025-07-18T09:24:08+0530",
"last_modified_time": "2025-07-18T09:24:09+0530",
"category_tax_preferences": [
{
"tax_specification": "intra",
"tax_id": "982000000037049"
}
],
"custom_fields": [
{
"index": 1,
"value": "Premium"
}
],
"ancestors": [
{
"category_id": "460000000038080",
"name": "Gadgets",
"url": "gadgets",
"parent_category_id": "-1",
"visibility": true,
"show_in_menu": true,
"created_time": "2025-07-18T09:24:08+0530",
"last_modified_time": "2025-07-18T09:24:09+0530"
}
],
"children": [
{
"category_id": "460000000038080",
"name": "Gadgets",
"url": "gadgets",
"parent_category_id": "-1",
"visibility": true,
"show_in_menu": true,
"created_time": "2025-07-18T09:24:08+0530",
"last_modified_time": "2025-07-18T09:24:09+0530"
}
],
"products": [
{...}
]
}
}
Delete a category
AI Tools
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Open in ChatGPT
Open in ChatGPT to ask questions about this page
Open in Claude
Open in Claude to ask questions about this page
Copy as Markdown
Copy this page as markdown to use with AI assistants
View as Markdown
Open this page as markdown in a new tab
Delete an existing category.
OAuth Scope : ERP.categories.DELETE
Path Parameters
category_id
string
(Required)
Unique identifier of the category. Note: This value is a set of numeric characters.
Query Parameters
organization_id
string
(Required)
ID of the organization. Note: This value is a set of numeric characters.
delete_sub_categories
boolean
If
true, deletes sub-categories of the specified category as well.headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.in/erp/v3/categories/460000000038080?organization_id=10234695"
type: DELETE
headers: headers_data
connection: <connection_name>
];
info response;
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://www.zohoapis.in/erp/v3/categories/460000000038080?organization_id=10234695")
.delete(null)
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
const options = {
method: 'DELETE',
headers: {
Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
}
};
fetch('https://www.zohoapis.in/erp/v3/categories/460000000038080?organization_id=10234695', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
import http.client
conn = http.client.HTTPSConnection("www.zohoapis.in")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("DELETE", "/erp/v3/categories/460000000038080?organization_id=10234695", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
const http = require("https");
const options = {
"method": "DELETE",
"hostname": "www.zohoapis.in",
"port": null,
"path": "/erp/v3/categories/460000000038080?organization_id=10234695",
"headers": {
"Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
curl --request DELETE \
--url 'https://www.zohoapis.in/erp/v3/categories/460000000038080?organization_id=10234695' \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
{
"code": 0,
"message": "Category deleted successfully."
}