> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Create Custom Module

- Component: `appmixer.zoho.crm.CreateCustomModule`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.zoho.crm 2.4.5](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.CreateCustomModule>

Creates a custom module in Zoho CRM. Custom modules are available in paid Zoho CRM editions only.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Singular Label (`singularLabel`) | text | The name of one record of the module, e.g. "Service Contract". Up to 25 letters, numbers and spaces. |
| Plural Label (`pluralLabel`) | text | The name of the module, e.g. "Service Contracts". Up to 25 letters, numbers and spaces. |
| API Name (`apiName`) | text | The API name of the module, e.g. "Service_Contracts". It must start with a letter. Zoho derives it from the plural label when empty. |
| Profile IDs (`profileIds`) | text | Comma separated IDs of the profiles that get access to the module. When empty, all profiles of the organization get access. |
| Display Field Label (`displayFieldLabel`) | text | The label of the field that names a record of the module. Zoho uses " Name" when empty. |
| Display Field Type (`displayFieldType`) | select | Only used with Display Field Label. Text lets users type the record name, Auto Number generates it. |
| Auto Number Start (`autoNumberStart`) | number | Only used with the Auto Number display field. The first number of the sequence, 1 when empty. |
| Auto Number Prefix (`autoNumberPrefix`) | text | Only used with the Auto Number display field. Text put before the number. |
| Auto Number Suffix (`autoNumberSuffix`) | text | Only used with the Auto Number display field. Text put after the number. |

## Output ports

### Port `out`

| Field | Type | Description |
| --- | --- | --- |
| ID (`id`) | string | - |
| API Name (`api_name`) | string | - |
| Module Name (`module_name`) | string | - |
| Singular Label (`singular_label`) | string | - |
| Plural Label (`plural_label`) | string | - |
| Generated Type (`generated_type`) | string | - |
| Status (`status`) | string | - |
| Visibility (`visibility`) | integer | - |
| API Supported (`api_supported`) | boolean | - |
| Creatable (`creatable`) | boolean | - |
| Editable (`editable`) | boolean | - |
| Deletable (`deletable`) | boolean | - |
| Modified Time (`modified_time`) | string | - |
| Modified By (`modified_by`) | object | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.zoho.crm.CreateCustomModule",
  "label": "Create Custom Module",
  "description": "Creates a custom module in Zoho CRM. Custom modules are available in paid Zoho CRM editions only.",
  "author": "Appmixer <info@appmixer.com>",
  "version": "1.0.0",
  "auth": {
    "service": "appmixer:zoho",
    "scope": [
      "ZohoCRM.settings.modules.ALL",
      "ZohoCRM.settings.modules.READ",
      "ZohoCRM.settings.profiles.READ"
    ]
  },
  "quota": {
    "manager": "appmixer:zoho",
    "resources": "requests",
    "scope": {
      "userId": "{{userId}}"
    }
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "singularLabel": {
            "type": "string",
            "maxLength": 25
          },
          "pluralLabel": {
            "type": "string",
            "maxLength": 25
          },
          "apiName": {
            "type": "string",
            "maxLength": 50
          },
          "profileIds": {
            "type": "string"
          },
          "displayFieldLabel": {
            "type": "string"
          },
          "displayFieldType": {
            "type": "string",
            "enum": [
              "text",
              "autonumber"
            ]
          },
          "autoNumberStart": {
            "type": "integer"
          },
          "autoNumberPrefix": {
            "type": "string",
            "maxLength": 50
          },
          "autoNumberSuffix": {
            "type": "string",
            "maxLength": 50
          }
        },
        "required": [
          "singularLabel",
          "pluralLabel"
        ]
      },
      "inspector": {
        "inputs": {
          "singularLabel": {
            "type": "text",
            "label": "Singular Label",
            "index": 1,
            "tooltip": "The name of one record of the module, e.g. \"Service Contract\". Up to 25 letters, numbers and spaces."
          },
          "pluralLabel": {
            "type": "text",
            "label": "Plural Label",
            "index": 2,
            "tooltip": "The name of the module, e.g. \"Service Contracts\". Up to 25 letters, numbers and spaces."
          },
          "apiName": {
            "type": "text",
            "label": "API Name",
            "index": 3,
            "tooltip": "The API name of the module, e.g. \"Service_Contracts\". It must start with a letter. Zoho derives it from the plural label when empty."
          },
          "profileIds": {
            "type": "text",
            "label": "Profile IDs",
            "index": 4,
            "tooltip": "Comma separated IDs of the profiles that get access to the module. When empty, all profiles of the organization get access."
          },
          "displayFieldLabel": {
            "type": "text",
            "label": "Display Field Label",
            "index": 5,
            "tooltip": "The label of the field that names a record of the module. Zoho uses \"<Singular Label> Name\" when empty."
          },
          "displayFieldType": {
            "type": "select",
            "label": "Display Field Type",
            "index": 6,
            "defaultValue": "text",
            "tooltip": "Only used with Display Field Label. Text lets users type the record name, Auto Number generates it.",
            "options": [
              {
                "label": "Text",
                "value": "text"
              },
              {
                "label": "Auto Number",
                "value": "autonumber"
              }
            ]
          },
          "autoNumberStart": {
            "type": "number",
            "label": "Auto Number Start",
            "index": 7,
            "tooltip": "Only used with the Auto Number display field. The first number of the sequence, 1 when empty."
          },
          "autoNumberPrefix": {
            "type": "text",
            "label": "Auto Number Prefix",
            "index": 8,
            "tooltip": "Only used with the Auto Number display field. Text put before the number."
          },
          "autoNumberSuffix": {
            "type": "text",
            "label": "Auto Number Suffix",
            "index": 9,
            "tooltip": "Only used with the Auto Number display field. Text put after the number."
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "ID",
            "example": "4876876000000834002"
          },
          "api_name": {
            "type": "string",
            "title": "API Name",
            "example": "Service_Contracts"
          },
          "module_name": {
            "type": "string",
            "title": "Module Name",
            "example": "CustomModule1"
          },
          "singular_label": {
            "type": "string",
            "title": "Singular Label",
            "example": "Service Contract"
          },
          "plural_label": {
            "type": "string",
            "title": "Plural Label",
            "example": "Service Contracts"
          },
          "generated_type": {
            "type": "string",
            "title": "Generated Type",
            "example": "custom"
          },
          "status": {
            "type": "string",
            "title": "Status",
            "example": "visible"
          },
          "visibility": {
            "type": "integer",
            "title": "Visibility",
            "example": 1
          },
          "api_supported": {
            "type": "boolean",
            "title": "API Supported",
            "example": true
          },
          "creatable": {
            "type": "boolean",
            "title": "Creatable",
            "example": true
          },
          "editable": {
            "type": "boolean",
            "title": "Editable",
            "example": true
          },
          "deletable": {
            "type": "boolean",
            "title": "Deletable",
            "example": true
          },
          "modified_time": {
            "type": "string",
            "title": "Modified Time",
            "example": "2026-08-28T16:40:00+00:00"
          },
          "modified_by": {
            "type": "object",
            "title": "Modified By",
            "properties": {
              "id": {
                "type": "string",
                "title": "Modified By.ID",
                "example": "4876876000000306001"
              },
              "name": {
                "type": "string",
                "title": "Modified By.Name",
                "example": "John Smith"
              }
            }
          }
        }
      }
    }
  ],
  "icon": "(data URI omitted)"
}
```
