Zoho mail Developer Space gives developers and businesses the tools to extend the capabilities of their email platform. You can use it to build custom applications, connect third-party services, access Zoho Mail data through APIs, and automate activities between different applications.
Imagine your team receives customer enquires through Zoho mail. You want those enquiries to create records in your CRM automatically, notify your support team, or trigger an action in another business application. Developer space provides the tools to build these connections.
| Feature | What it does | When you would use it |
| Develop Extension | Lets you build custom applications that work within Zoho Mail's eWidget. | When you want to bring a business application or custom functionality into your inbox. |
| REST API | Provides programmatic access to Zoho Mail features and data. | When you want to connect Zoho Mail with another application or automate email-related operations. |
| Connectors | Simplifies authentication with third-party applications. | When your extension needs authorized access to an external service. |
| Webhooks | Connects applications through event-based triggers and actions. | When an event in one application needs to initiate an action in another. |
What can you do with Developer Space?
Developer Space helps you customize how Zoho Mail interacts with your existing applications and business processes. Rather than relying only on the standard features available in your mailbox, you can build integrations that address your organization's specific requirements.
Here are some of the things you can accomplish:
-
Build custom eWidget extensions: Create applications that appear inside Zoho Mail, allowing users to access relevant tools without leaving their inbox.
-
Integrate third-party applications: Connect external services with Zoho Mail to exchange information and support connected workflows.
-
Access Zoho Mail APIs: Retrieve and manage supported email, account, organization, group, and other data programmatically.
-
Simplify authentication: Use connectors to authorize access to third-party applications through supported authentication methods.
-
Automate business processes: Configure webhooks to trigger actions when specific email, task, or Streams events occur.
-
Share extensions: Make your custom extensions available to other members of your organization, subject to the applicable approval process.
-
Publish extensions: Submit eligible extensions for review and distribution through Zoho Marketplace.
Developer Space capabilities at a glance
| Business requirement | Developer Space solution |
| Bring an external application into the mailbox | Develop Extension |
| Retrieve email or account information programmatically | REST API |
| Authenticate with an external application | Connectors |
| Trigger an action when an email arrives | Outgoing Webhook |
| Send an external application's event into Zoho Mail | Incoming Webhook |
| Build an integration for a specific organizational workflow | Extensions, APIs, and Webhooks |
Develop Extension
The Develop Extension option allows you to create custom applications that work within Zoho Mail’s eWidget. You can build an extension to introduce new functionality into your mailbox or connect an existing third-party application with Zoho Mail.
What can you build with extensions?
-
Custom business applications: Develop tools that address specific requirements within your organization.
-
Third-party integrations: Connect external applications and display relevant information inside Zoho Mail.
-
Workflow-based widgets: Build extensions that help users complete specific tasks from the mailbox.
-
Organization-specific solutions: Create extensions for internal teams and make them available to authorized colleagues.
-
Marketplace extensions: Submit eligible extensions for review and publication so other Zoho users can install them.
How to get started with extension development
Zoho provides the Zoho Sigma platform and Zoho Extension Toolkit (ZET) CLI to support extension development.
| Development method | Purpose |
| Zoho Sigma | Create and manage extensions through Zoho's developer platform. |
| ZET CLI | Create, run, validate, and package extensions using command-line tools. |
A typical development workflow involves the following steps:
-
Create a workspace: Sign in to Zoho Sigma and create a workspace for your extension projects.
-
Create a new extension: Select Zoho Mail as the service and provide the extension name and description.
-
Configure the extension: Define the application structure, widget location, permissions, and other required settings in the plugin manifest.
-
Develop the application: Add the required HTML, CSS, JavaScript, and application resources.
-
Connect external services: Configure connectors if your extension needs to communicate with third-party applications.
-
Test the extension: Run and validate the extension before submitting it.
-
Package and publish: Prepare the extension package and submit it through Zoho's publishing process.
REST API
A REST API (Representational State Transfer Application Programming Interface) allows two applications to communicate with each other through defined HTTP requests and responses.
Zoho Mail provides REST APIs that let developers access supported features and data programmatically. You can use these APIs to build custom applications, automate administrative activities, and integrate Zoho Mail with other business systems.
For example, an organization may want to retrieve user details, manage email groups, create folders, or work with email messages through an internal application. The relevant Zoho mail APIs can support these operations, provided the application has the required permissions and authorization.
What can you do with Zoho Mail REST APIs?
Zoho Mail provides APIs across several functional areas.
| API category | What it helps you manage |
| Organization API | Organization details, subscription information, and supported organization settings. |
| Domain API | Domain-related information and configuration. |
| Groups API | Create and manage groups, memberships, and related group settings. |
| Users API | Retrieve and manage organization user information through supported operations. |
| Mail Policy API | Manage supported email, account, access, and forwarding policies. |
| Accounts API | Access supported account settings and information. |
| Folders API | Create, retrieve, rename, and manage email folders through supported endpoints. |
| Labels API | Manage supported email labels. |
| Email Messages API | Perform supported operations on email messages. |
| Threads API | Access and manage supported email conversation information. |
| Tasks API | Work with supported task-related operations. |
| Notes and Bookmarks APIs | Access and manage supported notes and bookmarks. |
How REST API integration works
A typical API integration follows this process:
-
Identify the requirement: Decide what information or functionality your application needs from Zoho Mail.
-
Select the appropriate API: Refer to the Zoho Mail API documentation and identify the relevant endpoint.
-
Configure authorization: Generate the required OAuth token and request the necessary scopes.
-
Send an API request: Use the appropriate HTTP method and endpoint to perform the operation.
-
Process the response: Read the API response, handle errors, and use the returned information in your application.
-
Test the integration: Verify that the application performs the intended operation securely and reliably.
Connectors
When you build an extension that communicates with an external application, authentication is one of the first challenges you need to address.
For example, imagine your extension connects Zoho Mail with a third-party CRM. The extension may need to retrieve customer records from the CRM. Before it can do so, Zoho Mail must be authorized to access the CRM's API.
Connectors simplify this authentication process. You can configure a connector in Zoho Mail and use it while developing your extension, rather than implementing the entire third-party authentication flow yourself.
Supported authentication methods
Zoho Mail connectors support the following authentication methods:
| Authentication method | Description | Typical use |
| API Key | Uses a key provided by the external application to authorize requests. | Services that authenticate API requests using an API key. |
| OAuth 1.0 | Uses the OAuth 1.0 authorization mechanism. | Applications that support OAuth 1.0 authentication. |
| OAuth 2.0 | Uses an authorization and token-based process to grant access. | Modern applications that use OAuth 2.0 for API authorization. |
The authentication method you choose depends on the requirements of the third-party application.
How to configure a connector
Follow these steps to create a connector in Zoho Mail:
-
Sign in to your Zoho Mail account.
-
Navigate to Settings → Integrations → Developer Space.
-
Select Connectors from the left-side menu.
-
Click Create Connection.
-
Enter the required connection details.
| Field | What you need to enter |
| Service Name | The identifier used for the connector in your extension's plugin manifest. |
| Display Name | A name that helps you identify the connection in Zoho Mail. |
| Token Type | The format of the access token, such as the supported Bearer or MAC token type. |
| Authentication Type | Select API Key, OAuth 1.0, or OAuth 2.0, depending on the external application's requirements. |
| Authentication Details | Provide the credentials and other required information for the selected authentication method. |
Webhooks
Webhooks allow different applications to communicate through event-based notifications. Instead of repeatedly checking another application for updates, you can configure a webhook to trigger an action when a specific event occurs.
Zoho Mail supports Incoming Webhooks and Outgoing Webhooks. These help connect Zoho Mail with other Zoho applications and supported third-party services.
For example, you may want a notification to appear in a Streams group whenever a particular event occurs in a external application. Alternatively, you may want a new email or task in Zoho Mail to trigger an action in another system.
Incoming Webhooks
An incoming webhook allows an external application to send information to Zoho Mail when a configured event occurs.
Depending on the configuration, the incoming webhook can be used to:
-
Send information to your Zoho Mail inbox as an email.
-
Create a post in a selected Streams group.
-
Add a note to a Streams group.
-
Create a task in a Streams group.
-
Process incoming data through a custom function where required.
How to configure an Incoming Webhook
-
Sign in to Zoho Mail.
-
Navigate to Settings - Integrations - Developer Space.
-
Select Incoming Webhooks under the Configure section.
-
Click Add New Configuration.
-
Select the required post format.
| Option | Purpose |
| Sends the webhook update to your inbox as an email. | |
| Post | Creates a post in the selected Streams group. |
| Notes | Creates a note in the selected Streams group. |
| Task | Creates a task in the selected Streams group. |
-
If you select Post, Notes, or Task, provide the required custom username and Streams group details.
-
Configure a custom function if you need to modify the incoming data to match the required format.
-
Click Generate URL and copy the generated webhook URL.
-
Configure the external application to send event data to this URL.
The generated URL is used by the external application to send information into Zoho Mail.
Outgoing Webhooks
An outgoing webhook works in the opposite direction. It sends information from Zoho Mail to an external application when a configured event occurs.
You can configure outgoing webhooks for supported events involving:
-
Incoming emails.
-
Newly created tasks and selected task activities.
-
New or updated activities involving Streams posts, depending on the configured options.
How to configure an Outgoing Webhook
-
Sign in to Zoho Mail.
-
Navigate to Settings - Integrations - Developer Space.
-
Select Outgoing Webhooks under the Configure section.
-
Click Add New Configuration.
-
Enter a custom username and the webhook URL provided by the receiving application.
-
Select the entity you want to monitor: Mail, Tasks, or Streams Post.
-
Configure the relevant conditions and activities.
-
Choose whether to send the full or limited data set, wherever the option is available.
-
Configure a custom function if you need to modify the outgoing request data.
-
Click Save.
Incoming vs. Outgoing Webhooks
| Feature | Incoming Webhook | Outgoing Webhook |
| Direction | External application - Zoho Mail | Zoho Mail - External application |
| Purpose | Sends external events into Zoho Mail. | Sends selected Zoho Mail events to another application. |
| Example | Create a Streams task when an external system sends an update. | Notify another application when a new email arrives. |
| Configuration | Generate a webhook URL in Zoho Mail and use it in the external application. | Enter the receiving application's webhook URL in Zoho Mail. |
Important considerations when using Webhooks
-
Protect webhook URLs: Treat generated URLs as sensitive credentials. Anyone with access to an exposed incoming webhook URL may be able to send updates to the configured destination.
-
Use appropriate conditions: Configure filters carefully so that only relevant events trigger the webhook.
-
Limit shared data: Use limited data options when the receiving application does not need the complete event information.
-
Check the receiving application: Make sure the destination URL is configured to accept and process the webhook requests.
-
Monitor failures: Check webhook configurations if events are not reaching the intended application.
-
Regenerate exposed URLs: If a webhook URL is compromised, regenerate it and update every external application that uses the old URL.
Webhooks are particularly useful when you want applications to respond to events automatically rather than depending on manual updates or repeated checks.

