Create New Department

Description

You can use this API to create a new department.

Request Payload

  • name: Name of the department(Mandatory) 
  • is_public: To set the department public or private(Values: true|false)
  • description: Description about the department 
  • operators: The list of operator IDs that you would want to associate with the department (Mandatory)
  • email_configurations: Email Configurations for the particular department 
    • from_email: Email address used by the department in the From field
    • is_transcript_mail_enabled: To enable the email chat transcript option
    • transcript_recipients: The chat transcript will be forwarded to the given email address
    • is_blockip_mail_enabled: To enable the email notification when operators block IP addresses
    • blockip_recipients: The visitor details of the blocked IP will be sent to this email address
    • is_feedback_mail_enabled: To enable email notification for feedback received from the visitors
    • feedback_recipients: The visitor's feedback will be sent to this email address
    • is_missedchat_mail_enabled: To enable missed visitor email notifications
    • missedchat_recipients: The missed visitor notifications will be sent to this email address
    • is_cc_mail_enabled: To enable the adding of 'CC' email address automatically to the reply emails
    • cc_recipients: This email will be added automatically for the reply emails sent to the visitor

OAuth Scope:

SalesIQ.departments.CREATE

URL

Copiedhttps://{[zohosalesiq_server_uri](https://www.zoho.com/salesiq/help/developer-section/rest-api-v2.html)}/api/v2/{screen name}/departments

Example

Copiedhttps://salesiq.zoho.com/api/v2/zylker-inc/departments

Success Response

Copied{
  "url": "/api/v2/zylker-fashions/departments",
  "object": "department",
  "data": {
    "email_configurations": {
      "missedchat_recipients": "patricia@zylker.com",
      "image_url": "/api/v2/zylker/downloads/1526214218274_33290000000002013?purpose=department_image",
      "feedback_recipients": "support@zylker.com",
      "is_missedchat_mail_enabled": "true",
      "is_cc_mail_enabled": "true",
      "from_email": "Fashions@zylker.com",
      "is_transcript_mail_enabled": "true",
      "transcript_recipients": "support@zylker.com",
      "is_blockip_mail_enabled": "true",
      "blockip_recipients": "admin@zylker.com",
      "cc_recipients": "admin@zylker.com",
      "is_feedback_mail_enabled": "true"
    },
    "modified_time": "1524153593243",
    "name": "Zylker-Fashions",
    "id": "32308000000002051",
    "is_enabled": "false",
    "operators": [
      "32308000000002001"
    ],
    "created_by": "32308000000002001",
    "is_public": "true",
    "is_system_generated": "false",
    "created_time": "1524153593243",
    "description": "World's best fashion brand",
    "display_name": "Zylker Fashions"
  }
}