Incomaker Commons v4
API Reference
API Reference
  1. Products
  • Incomaker Commons v4
  • Social Accounts
    • Get Accounts
  • Ad Accounts
    • Get Accounts for Facebook
  • Assets
    • Generate e-mail content (AI)
  • Audiences
    • Get Audiences
  • Campaigns
    • Get campaigns
    • Archive Campaign
    • Pause/Resume/Cancel Campaign
    • Rename Campaign
    • Duplicate Campaign
    • Delete Campaign
    • Get Categories
    • Add New Category
  • Contacts
    • Get contact by clientContactId
    • Get contact by email
    • Add contact to the list by id
    • Remove contact from the list by id
    • Add contact to the list by name
    • Remove contact from the list by name
    • Get contact by phoneNumber1
    • Upsert multiple contacts (async)
    • Get contact events
    • Get contact events by client id
    • Get contact events by email
    • Get all contacts
    • Create contact
    • Upsert contact
    • Get contact
    • Update contact
    • Delete contact
    • Get total number of contacts
    • Upsert multiple contacts
    • Delete multiple contacts
    • Contact login
    • Contact logout
    • Get contact`s subscriptions
    • Replace contact's subscriptions (full set)
    • Adjust contact's subscriptions (partial)
    • Unsubscribe a contact from all lists
  • Carts
    • Add an Item to Cart
    • Remove an Item from Cart
    • Create an Order from Cart (checkout)
  • Deals
    • Get deal
    • Update deal
    • Delete deal
    • Find deals
    • Create deal
    • Get deals attachments
    • Post deals attachment
    • Delete deals attachment
    • Get deals contacts
    • Add deals contacts
    • Remove contact from deal
    • Get deals activities
    • List deal states
    • Create deal state
    • Update deal state
    • Delete deal state
  • Delivery
    • Send E-mails delivery
    • Send SMS delivery
    • Send push delivery
    • Send Test E-mail
    • Send Test SMS
    • Send Test Push
    • Validate E-mail (dry run)
    • Validate SMS (dry run)
    • Validate Push (dry run)
    • Get Delivery Job
    • List Delivery Jobs
    • Cancel Delivery Job
    • Pause Delivery Job
  • Events
    • Get event types
    • Custom event
  • Forms
    • Get form settings
    • Update form settings
    • Get form field mappings
    • Update form field mappings
  • Notifications
    • Get notifications
    • Get notification
    • Modify notification
    • Delete notification
  • Lists
    • Get Lists
    • Create List
    • Get List
    • Update List
    • Delete List
    • Get List by name
    • Update List by name
    • Delete List by name
    • Get number of contacts for a list
    • Get number of contacts for a list by name
    • Get contact counts for all lists (grouped by category)
    • Upsert Lists (bulk)
    • Get List categories
    • Create List category
    • Get List category
    • Update List category
    • Delete List category
    • Get List category by name
    • Update List category by name
    • Delete List category by name
    • Upsert List categories (bulk)
  • Products
    • Get total number of products
      GET
    • Delete multiple products
      DELETE
    • Get variant
      GET
    • Get products
      GET
    • Get products categories
      GET
    • Get tags
      GET
    • Create product
      POST
    • Upsert product
      PUT
    • Upsert multiple products (sync)
      PUT
    • Upsert multiple products (async job)
      POST
    • Get product
      GET
    • Replace product
      PUT
    • Partially update product
      PATCH
    • Delete (deactivate) product
      DELETE
    • Upsert single variant
      PUT
    • Partially update variant
      PATCH
    • Delete (deactivate) variant
      DELETE
    • Add tag to product
      PUT
    • Remove tag from product
      DELETE
    • Add product to category
      PUT
    • Remove product from category
      DELETE
    • Create product category
      POST
    • Upsert product category
      PUT
    • Upsert multiple product categories
      PUT
    • Get product category
      GET
    • Replace product category
      PUT
    • Partially update product category
      PATCH
    • Delete (hide) product category
      DELETE
  • Orders
    • Get orders
    • Create order
    • Upsert multiple orders
    • Get order
    • Update order
    • Update order state
    • Delete order
    • Get order by client ID
    • Update order by client ID
    • Update order state by client ID
    • Delete order by client ID
  • Scenarios
    • Abandoned cart notification by e-mail
    • Abandoned cart notification by SMS
    • Abandoned cart notification by push
    • Abandoned cart notification by Facebook
    • Create birthday greetings
    • Create nameday greetings
    • Create first purchase anniversary
  • Smartflows
    • Triggers
      • Start
        • Get Start trigger
        • Delete Start trigger
        • Create Start trigger
      • Added to list
      • Removed from list
      • Scheduled start
        • Get Scheduled start trigger
        • Update Scheduled start trigger
        • Delete Scheduled start trigger
        • Create Scheduled start trigger
      • Recurring
        • Get Recurring trigger
        • Update Recurring trigger
        • Delete Recurring trigger
        • Create Recurring trigger
      • Nameday
        • Get Nameday trigger
        • Update Nameday trigger
        • Delete Nameday trigger
        • Create Nameday trigger
      • Birthday
        • Get Birthday trigger
        • Update Birthday trigger
        • Delete Birthday trigger
        • Create Birthday trigger
      • First registration
        • Get First registration trigger
        • Update First registration trigger
        • Delete First registration trigger
        • Create First registration trigger
      • First purchase
        • Get First purchase trigger
        • Update First purchase trigger
        • Delete First purchase trigger
        • Create First purchase trigger
      • Email subscription confirmed
        • Get Email subscription confirmed trigger
        • Update Email subscription confirmed trigger
        • Delete Email subscription confirmed trigger
        • Create Email subscription confirmed trigger
      • Link click
        • Get Link click trigger
        • Update Link click trigger
        • Delete Link click trigger
        • Create Link click trigger
      • Mail open
        • Get Open mail trigger
        • Update Open mail trigger
        • Delete Open mail trigger
        • Create Open mail trigger
      • Product added to cart
        • Get Product added to cart trigger
        • Update Product added to cart trigger
        • Delete Product added to cart trigger
        • Create Product added to cart trigger
      • Custom event
        • Get Custom event trigger
        • Update Custom event trigger
        • Delete Custom event trigger
        • Create Custom event trigger
      • Abandoned cart
        • Get Abandoned cart trigger
        • Update Abandoned cart trigger
        • Delete Abandoned cart trigger
        • Create Abandoned cart trigger
    • Actions
      • Double Opt-In
        • Get Double Opt-In action
        • Update Double Opt-In action
        • Delete Double Opt-In action
        • Create Double Opt-In action
        • Swap branches
      • Add contact to list
        • Get Add contact to list action
        • Update Add contact to list action
        • Delete Add contact to list action
        • Create Add contact to list action
      • Remove contact from list
        • Get Remove contact from list action
        • Update Remove contact from list action
        • Delete Remove contact from list action
        • Create Remove contact from list action
      • Sklik Audience
        • Get Sklik audience action
        • Update Sklik audience action
        • Delete Sklik audience action
        • Create Sklik audience action
        • Connect Sklik account
        • Disconnect Sklik account
        • Get Sklik audiences for action
      • Meta audience
        • Get Meta audience action
        • Update Meta audience action
        • Delete Meta audience action
        • Create Meta audience action
        • Get Meta audiences for action
        • Connect Meta Account
        • Disconnect Meta account
        • Get list of business portfolios
        • Get list of advertising accounts
      • Teaser
        • Get Teaer action
        • Create Teaer action
        • Delete Teaer action
    • Targets
    • Activities
      • Convert activity
      • Duplicate activity
      • Enable/Disable activity
      • Update activity shared fields
    • Structure
      • Get smartflow structure
      • Delete a part of smartflow
    • Get Added to contact list trigger
    • Get smartflows
    • Update Added to contact list trigger
    • Create smartflow
    • Delete Added to contact list trigger
    • Get smartflow
    • Create Added to contact list trigger
    • Update smartflow
    • Get Removed from contact list trigger
    • Delete smartflow
    • Update Remove from contact list trigger
    • Delete Remove from contact list trigger
    • Generate smartflow (AI)
    • Create Removed from contact list trigger
    • Pause/Resume/Cancel smartflow
    • Execute smartflow
    • Validate smartflow
    • Export smartflow
    • Import smartflow
    • Duplicate smartflow
    • Get smartflow actions
    • Archive smartflow
    • Get templates
    • Create template
    • Get template actions
    • Get folders
    • Create folder
    • Modify folder
    • Delete folder
    • Get Product in Cart is back in Stock trigger
    • Update Product in cart is back in stock trigger
    • Delete Product in cart is back in stock trigger
    • Create Product in cart is back in stock trigger
    • Get Product in Cart discounted trigger
    • Update Product in Cart discounted trigger
    • Delete Product in Cart discounted trigger
    • Create Product in Cart discounted trigger
    • Get Product in cart running out trigger
    • Update Product in cart running out trigger
    • Delete Product in cart running out trigger
    • Create Product in cart running out trigger
    • Get Product purchased trigger
    • Update Product purchased trigger
    • Delete Product purchased trigger
    • Create Product purchased trigger
    • Get Recently purchased trigger
    • Update Recently purchased trigger
    • Delete Recently purchased trigger
    • Create Recently purchased trigger
    • Get Checkout visited trigger
    • Update Checkout visited trigger
    • Delete Checkout visited trigger
    • Create Checkout visited trigger
    • Get Order cancelled trigger
    • Delete Order cancelled trigger
    • Create Order cancelled trigger
    • Get Invoice confirmation trigger
    • Delete Invoice confirmation trigger
    • Create Invoice confirmation trigger
    • Get Return confirmation trigger
    • Delete Return confirmation trigger
    • Create Return confirmation trigger
    • Get Website search trigger
    • Update Website search trigger
    • Delete Website search trigger
    • Create Website search trigger
    • Get Campaign sent trigger
    • Update Campaign sent trigger
    • Delete Campaign sent trigger
    • Create Campaign sent trigger
    • Get Shipping confirmed trigger
    • Update Shipping confirmed trigger
    • Delete Shipping confirmed trigger
    • Create Shipping confirmed trigger
    • Get Website Viewed trigger
    • Update Website Viewed trigger
    • Delete Website Viewed trigger
    • Create Website Viewed trigger
    • Get Filter target
    • Update Filter target
    • Delete Filter target
    • Create Filter target
    • Get Merge target
    • Delete Merge target
    • Create Merge target
    • Get Split target
    • Update Split target
    • Delete Split target
    • Create Split target
    • Get Splitter target
    • Update Splitter target
    • Delete Splitter target
    • Create Splitter target
    • Get Condition target
    • Update Condition target
    • Delete Condition target
    • Create Condition target
    • Get A/B test target
    • Update AB test target
    • Delete AB test target
    • Create AB test target
    • Get Send mail action
    • Update Send email action
    • Delete Send mail action
    • Create Send mail action
    • Get Send sms action
    • Update Send sms action
    • Delete Send sms action
    • Create Send sms action
    • Get Send social post action
    • Update Send social post action
    • Delete Send social post action
    • Create Send social post action
    • Get Send NPS action
    • Update Send NPS action
    • Delete Send NPS action
    • Create Send NPS action
    • Get Webhook action
    • Update Webhook action
    • Delete Webhook action
    • Create Webhook action
    • Get Delay action
    • Update Delay action
    • Delete Delay action
    • Create Delay action
    • Get Landing page action
    • Update Landing page action
    • Delete Landing page action
    • Create Landing page action
    • Get Add tag action
    • Update Add tag action
    • Delete Add tag action
    • Create Add tag action
    • Get Remove tag action
    • Update Remove tag action
    • Delete Remove tag action
    • Create Remove tag action
    • Get Unsubscribe action
    • Update Unsubscribe action
    • Delete Unsubscribe action
    • Create Unsubscribe action
    • Get list of contact fields to update
    • Get Update contact action
    • Update Update contact action
    • Delete Update contact action
    • Create Update contact action
    • Get Popup action
    • Update Popup action
    • Delete Popup action
    • Create Popup action
  • Website
    • Get Website Info
    • Get Teaser settings
  • Tags
    • Get Tags
    • Create Tag
    • Update Tag
    • Get Tag
    • Delete Tag
    • Get number of contacts for a tag
    • Get contact counts for all tags (grouped by category)
    • Create Tags (bulk)
    • Get Tag categories
    • Create Tag category
    • Get Tag category
    • Update Tag category
    • Delete Tag category
    • Create Tag categories (bulk)
  • Context
    • Get Context
    • Update Context
    • Replace Context
  • Admin
    • Refresh Currency Rates
  • Jobs
    • Get job status
    • List jobs
    • List job items
    • Cancel job
  • Schemas
    • Audience
    • Notification
    • Error
    • CampaignType
    • Product tag
    • ProductCategoryWriteNoId
    • ProductWriteNoId
    • Price
    • Contact
    • Product (read)
    • CampaignChannel
    • CampaignState
    • Campaign
    • CustomField
    • Context
    • ProductLanguage
    • CreateActionResponse
    • ProductVariantWriteNoId
    • TeaserFontFamily
    • ProductVariantWrite
    • TeaserFontWeight
    • ProductWrite
    • TeaserCloseButtonSize
    • TeaserCloseButtonPosition
    • ProductVariant
    • TeaserPosition
    • NotificationSeverity
    • CategoryLanguage
    • NotificationChannel
    • Tag
    • ProductCategoryWrite
    • ProductCategory
    • TagCategory
    • UpsertResult
    • List
    • VariantUpsertResult
    • ListCategory
    • CategoryUpsertResult
    • SmartflowTemplateAction
    • BulkResult
    • SmartflowAction
    • CategoryBulkResult
    • SmartflowState
    • SmartflowCompletedState
    • SocialNetworkType
    • SocialNetworkEntityType
    • SocialNetworkEntity
    • SocialNetworkUser
    • Smartflow
    • SmartflowFolder
    • SocialAccount
    • AudienceInput
    • EmailAsset
    • SmsAsset
    • PushAsset
    • Cron
    • SocialAccountsResponse
    • AdAccount
    • AdAccountsResponse
    • AudiencesResponse
    • ProductsResponse
    • ProductsCategoriesResponse
    • ProductTagsResponse
    • SmartflowsResponse
    • SmartflowFoldersResponse
    • SmartflowActionsResponse
    • SmartflowTemplateActionsResponse
    • Paging
    • TeaserSettings
    • WebsiteSettings
    • General rules
    • PermId
    • Events
  1. Products

Upsert product category

PUT
/products/categories
Creates or replaces a category keyed on categoryId. Heals hidden placeholder categories auto-created by product writes that referenced this categoryId before it existed.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200OK
application/json
Updated
Bodyapplication/json

🟢201Created
🟠400Bad Request
🟠422Parameter Error
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT '/products/categories' \
--header 'Content-Type: application/json' \
--data '{
    "categoryId": "string",
    "parentCategoryId": "string",
    "visible": true,
    "languages": [
        {
            "id": "cs",
            "name": "string",
            "url": "http://example.com"
        }
    ]
}'
Response Response Example
200 - Example 1
{
    "categoryId": "string",
    "status": "created"
}
Modified at 2026-07-07 12:02:40
Previous
Create product category
Next
Upsert multiple product categories
Built with