Inquirly
  1. Help Center
Inquirly
  • Accounts
    • Create an Account
      POST
    • Get an account details
      GET
    • Update an account
      PATCH
    • Delete an Account
      DELETE
  • Account Users
    • List all Account Users
      GET
    • Create an Account User
      POST
    • Delete an Account User
      DELETE
  • AgentBots
    • List all AgentBots
      GET
    • Create an Agent Bot
      POST
    • Get an agent bot details
      GET
    • Update an agent bot
      PATCH
    • Delete an AgentBot
      DELETE
  • Users
    • Create a User
      POST
    • Get an user details
      GET
    • Update a user
      PATCH
    • Delete a User
      DELETE
    • Get User SSO Link
      GET
  • Inbox API
    • Inbox details
      GET
  • Contacts API
    • Create a contact
      POST
    • Get a contact
      GET
    • Update a contact
      PATCH
  • Conversations API
    • Create a conversation
    • List all conversations
    • Get a single conversation
    • Resolve a conversation
    • Toggle typing status
    • Update last seen
  • Messages API
    • Create a message
    • List all messages
    • Update a message
  • Contact Labels
    • List Labels
    • Add Labels
  • CSAT Survey Page
    • Get CSAT survey page
  • Account AgentBots
    • List all AgentBots
    • Create an Agent Bot
    • Get an agent bot details
    • Update an agent bot
    • Delete an AgentBot
  • Agents
    • List Agents in Account
    • Add a New Agent
    • Update Agent in Account
    • Remove an Agent from Account
  • Canned Responses
    • List all Canned Responses in an Account
    • Add a New Canned Response
    • Remove a Canned Response from Account
  • Canned Response
    • Update Canned Response in Account
  • Custom Attributes
    • List all custom attributes in an account
    • Add a new custom attribute
    • Get a custom attribute details
    • Update custom attribute in Account
    • Remove a custom attribute from account
  • Contacts
    • List Contacts
    • Create Contact
    • Show Contact
    • Update Contact
    • Delete Contact
    • Contact Conversations
    • Search Contacts
    • Contact Filter
  • Contact
    • Create contact inbox
    • Get Contactable Inboxes
  • Automation Rule
    • List all automation rules in an account
    • Add a new automation rule
    • Get a automation rule details
    • Update automation rule in Account
    • Remove a automation rule from account
  • Help Center
    • Add a new portal
      POST
    • List all portals in an account
      GET
    • update a new portal
      PATCH
    • Add a new category
      POST
    • Add a new article
      POST
  • Conversations
    • Get Conversation Counts
    • Conversations List
    • Create New Conversation
    • Conversations Filter
    • Conversation Details
    • Update Conversation
    • Toggle Status
    • Toggle Priority
  • Conversation Assignment
    • Assign Conversation
  • Conversation Labels
    • List Labels
    • Add Labels
  • Inboxes
    • List all inboxes
    • Get an inbox
    • Create an inbox
    • Update Inbox
    • Show Inbox Agent Bot
    • Add or remove agent bot
    • List Agents in Inbox
    • Add a New Agent
    • Update Agents in Inbox
    • Remove an Agent from Inbox
  • Messages
    • Get messages
    • Create New Message
    • Delete a message
  • Integrations
    • List all the Integrations
    • Create an integration hook
    • Update an Integration Hook
    • Delete an Integration Hook
  • Profile
    • Fetch user profile
  • Teams
    • List all teams
    • Create a team
    • Get a team details
    • Update a team
    • Delete a team
    • List Agents in Team
    • Add a New Agent
    • Update Agents in Team
    • Remove an Agent from Team
  • Custom Filters
    • List all custom filters
    • Create a custom filter
    • Get a custom filter details
    • Update a custom filter
    • Delete a custom filter
  • Webhooks
    • List all webhooks
    • Add a webhook
    • Update a webhook object
    • Delete a webhook
  • Reports
    • Get Account reports
    • Get Account reports summary
    • Account Conversation Metrics
    • Agent Conversation Metrics
  1. Help Center

Add a new category

POST
/api/v1/accounts/{account_id}/portals/{portal_id}/categories
Help Center
Add a new category to portal
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/accounts//portals//categories' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
    "description": "string",
    "locale": "en/es",
    "name": "string",
    "slug": "string",
    "position": 0,
    "portal_id": 0,
    "account_id": 0,
    "associated_category_id": 0,
    "parent_category_id": 0
}'
Response Response Example
200 - Example 1
{
    "id": 0,
    "description": "string",
    "locale": "string",
    "name": "string",
    "slug": "string",
    "position": 0,
    "portal_id": 0,
    "account_id": 0,
    "associated_category_id": 0,
    "parent_category_id": 0
}

Request

Path Params
account_id
string 
required
portal_id
string 
required
Body Params application/json; charset=utf-8
description
string 
optional
Category description
locale
string 
optional
Category locale
Example:
en/es
name
string 
optional
Category name
slug
string 
optional
Category slug
position
integer 
optional
Category position in the portal list to sort
portal_id
integer 
optional
account_id
integer 
optional
associated_category_id
integer 
optional
To associate similar categories to each other, e.g same category of product documentation in different languages
parent_category_id
integer 
optional
To define parent category, e.g product documentation has multiple level features in sales category or in engineering category.
Examples

Responses

🟢200OK
application/json; charset=utf-8
Success
Body
id
integer 
optional
description
string 
optional
The text content.
locale
string 
optional
name
string 
optional
slug
string 
optional
position
integer 
optional
portal_id
integer 
optional
account_id
integer 
optional
associated_category_id
integer 
optional
To associate similar categories to each other, e.g same category of product documentation in different languages
parent_category_id
integer 
optional
To define parent category, e.g product documentation has multiple level features in sales category or in engineering category.
🟠403Forbidden
Previous
update a new portal
Next
Add a new article
Built with