Actions981
- Account Actions
- Accounting Period Actions
- Adv Intercompany Journal Entry Actions
- Assembly Build Actions
- Assembly Item Actions
- Assembly Unbuild Actions
- Billing Account Actions
- Billing Revenue Event Actions
- Billing Schedule Actions
- Bin Actions
- Bin Transfer Actions
- Blanket Purchase Order Actions
- Bom Actions
- Bom Revision Actions
- Calendar Event Actions
- Campaign Actions
- Campaign Response Actions
- Cash Refund Actions
- Cash Sale Actions
- Charge Actions
- Check Actions
- Classification Actions
- Commerce Category Actions
- Competitor Actions
- Consolidated Exchange Rate Actions
- Contact Actions
- Contact Category Actions
- Contact Role Actions
- Cost Category Actions
- Coupon Code Actions
- Credit Card Charge Actions
- Credit Card Refund Actions
- Credit Memo Actions
- Currency Actions
- Currency Rate Actions
- Customer Actions
- Customer Category Actions
- Customer Deposit Actions
- Customer Message Actions
- Customer Payment Actions
- Customer Refund Actions
- Customer Status Actions
- Customer Subsidiary Relationship Actions
- [Custom Record] Actions
- Department Actions
- Deposit Actions
- Deposit Application Actions
- Description Item Actions
- Discount Item Actions
- Download Item Actions
- Email Template Actions
- Employee Actions
- Estimate Actions
- Expense Category Actions
- Expense Report Actions
- Fair Value Price Actions
- Fulfillment Request Actions
- Gift Certificate Item Actions
- Inbound Shipment Actions
- Intercompany Journal Entry Actions
- Intercompany Transfer Order Actions
- Inventory Adjustment Actions
- Inventory Cost Revaluation Actions
- Inventory Count Actions
- Inventory Item Actions
- Inventory Number Actions
- Inventory Transfer Actions
- Invoice Actions
- Issue Actions
- Item Fulfillment Actions
- Item Group Actions
- Item Receipt Actions
- Item Revision Actions
- Job Actions
- Job Status Actions
- Job Type Actions
- Journal Entry Actions
- Kit Item Actions
- Location Actions
- Manufacturing Cost Template Actions
- Manufacturing Operation Task Actions
- Manufacturing Routing Actions
- Markup Item Actions
- Merchandise Hierarchy Level Actions
- Merchandise Hierarchy Node Actions
- Merchandise Hierarchy Version Actions
- Message Actions
- Nexus Actions
- Non Inventory Purchase Item Actions
- Non Inventory Resale Item Actions
- Non Inventory Sale Item Actions
- Note Type Actions
- Opportunity Actions
- Other Charge Purchase Item Actions
- Other Charge Resale Item Actions
- Other Charge Sale Item Actions
- Other Name Actions
- Other Name Category Actions
- Partner Actions
- Paycheck Actions
- Payment Item Actions
- Payment Method Actions
- Phone Call Actions
- Price Book Actions
- Price Level Actions
- Price Plan Actions
- Pricing Group Actions
- Project Task Actions
- Promotion Code Actions
- Purchase Contract Actions
- Purchase Order Actions
- Purchase Requisition Actions
- Resource Group Actions
- Return Authorization Actions
- Rev Rec Schedule Actions
- Rev Rec Template Actions
- Sales Order Actions
- Sales Role Actions
- Sales Tax Item Actions
- Service Purchase Item Actions
- Service Resale Item Actions
- Service Sale Item Actions
- Ship Item Actions
- Statistical Journal Entry Actions
- Subscription Actions
- Subscription Change Order Actions
- Subscription Line Actions
- Subscription Plan Actions
- Subscription Term Actions
- Subsidiary Actions
- Subtotal Item Actions
- [SuiteQL] Actions
- Support Case Actions
- Task Actions
- Tax Type Actions
- Term Actions
- Time Bill Actions
- Time Sheet Actions
- Topic Actions
- Transfer Order Actions
- Units Type Actions
- Usage Actions
- Vendor Actions
- Vendor Bill Actions
- Vendor Category Actions
- Vendor Credit Actions
- Vendor Payment Actions
- Vendor Prepayment Actions
- Vendor Prepayment Application Actions
- Vendor Return Authorization Actions
- Vendor Subsidiary Relationship Actions
- Web Site Actions
- Work Order Actions
- Work Order Close Actions
- Work Order Completion Actions
- Work Order Issue Actions
Commerce Category → Insert record
AI-generatedSummary
Create a new NetSuite Commerce Category record.
Inputs
- name — Specify the name for this record.
- description — Specify a description for this record.
- externalId — External identifier for the record.
- isDebugMode — Whether to include full request and response info in the output
- authMethod — Authentication Method for the request to NetSuite. Defaults to OAuth1. Options: OAuth1, OAuth2.
- startDate — This identifies the start date and time for the record. If this is a future date, the content does not display until that date.
- endDate — This identifies the end date and time for the record. When this date is passed, the content is no longer visible the site. If there is no end date, the content does not expire.
- isInactive — Mark a category as inactive to prevent it from displaying on the website and prevent other activity, such as assignment as a subcategory.
- pageTitle — Enter a title for the page. This value populates the
element for a category page. - pageHeading — This heading displays at the top of the category page. The page template must be configured to display the heading.
- pageBanner — Collection with internal identifier (id) and external identifier (externalId) for the page banner.
- primaryParent — Collection with internal identifier (id) and external identifier (externalId) for the primary parent category.
- replace — The names of sublists on this record. All sublist lines will be replaced with lines specified in the request. Names are delimited by comma.
- sequenceNumber — This number controls the order of how categories are displayed in SMT. If left blank, sequence numbers are assigned automatically based on manual ordering.
- sitemapPriority — Sitemap priority for the category page. Collection with internal identifier (id) and predefined numeric values from 0.0 to 1.0.
- subcategories — Collection of subcategory overrides, including id, externalId, and various field overrides (description, displayInSite, heading, meta descriptions/keywords, name, page banner, reference name, sequence number, sitemap priority).
- tags — Collection of tags, each with internal identifier (id), name, and reference name (refName).
- urlFragment — The URL Fragment lets you specify the section of the URL for navigating to the category page. Enter the URL with no slashes (e.g., 'shoes'). URLs are case-sensitive; best practice is lower case.
- customFields — List of Custom Fields to add to the record. Each field includes a required field name (with load options from NetSuite), a required field type (boolean, dateTime, multiSelect, number, select, string), and a value appropriate to the type.
Output shape
The operation returns the created Commerce Category record with system-assigned internal identifier and all provided/or computed fields. Exact return shape depends on NetSuite REST API response and idempotency key usage.
If the request is executed asynchronously (Preference: respond-async), the response includes 'Preference-applied: respond-async'. The X-NetSuite-Idempotency-Key ensures the request executes only once per unique key (RFC 4122 UUID format).
Examples
Example 1: Create a basic Commerce Category with name and optional description.
Set the 'name' parameter to the desired category name. Optionally set 'description', 'externalId', 'startDate', and 'isInactive' as needed. Use default authentication (OAuth1) unless OAuth2 is required.