Zoho Mail Developer Space: Features, APIs, Extensions & Webhooks


Desicription : Explore Zoho Mail Developer Space, including custom extensions, REST APIs, connectors, and incoming and outgoing webhooks to automate business workflows and integrations.

Created at : 16 November 2022

Posted by Nishi on 12 November 2026


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:

  1. Create a workspace: Sign in to Zoho Sigma and create a workspace for your extension projects.
  2. Create a new extension: Select Zoho Mail as the service and provide the extension name and description.
  3. Configure the extension: Define the application structure, widget location, permissions, and other required settings in the plugin manifest.
  4. Develop the application: Add the required HTML, CSS, JavaScript, and application resources.
  5. Connect external services: Configure connectors if your extension needs to communicate with third-party applications.
  6. Test the extension: Run and validate the extension before submitting it.
  7. 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:

  1. Identify the requirement: Decide what information or functionality your application needs from Zoho Mail.
  2. Select the appropriate API: Refer to the Zoho Mail API documentation and identify the relevant endpoint.
  3. Configure authorization: Generate the required OAuth token and request the necessary scopes.
  4. Send an API request: Use the appropriate HTTP method and endpoint to perform the operation.
  5. Process the response: Read the API response, handle errors, and use the returned information in your application.
  6. 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:

  1. Sign in to your Zoho Mail account.
  2. Navigate to Settings → Integrations → Developer Space.
  3. Select Connectors from the left-side menu.
  4. Click Create Connection.
  5. 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

  1. Sign in to Zoho Mail.
  2. Navigate to Settings - Integrations - Developer Space.
  3. Select Incoming Webhooks under the Configure section.
  4. Click Add New Configuration.
  5. Select the required post format.
Option Purpose
Mail 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.
  1. If you select Post, Notes, or Task, provide the required custom username and Streams group details.
  2. Configure a custom function if you need to modify the incoming data to match the required format.
  3. Click Generate URL and copy the generated webhook URL.
  4. 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

  1. Sign in to Zoho Mail.
  2. Navigate to Settings - Integrations - Developer Space.
  3. Select Outgoing Webhooks under the Configure section.
  4. Click Add New Configuration.
  5. Enter a custom username and the webhook URL provided by the receiving application.
  6. Select the entity you want to monitor: Mail, Tasks, or Streams Post.
  7. Configure the relevant conditions and activities.
  8. Choose whether to send the full or limited data set, wherever the option is available.
  9. Configure a custom function if you need to modify the outgoing request data.
  10. 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.

Why Choose FGrade?

01

Migrations

FGrade handles seamless migrations ensuring your data is transferred accurately and securely. Our successful track record speaks for itself.

02

Certified Experts

Our team comprises certified professionals with extensive training in all IT products. Trust us to manage your HR systems with the utmost expertise.

03

Great Price Discounts

At FGrade, we're ready to help you implement customizing workflows, setting up approvals all these at lower prices.

Discover how Freshsales can streamline your business

Reach out to the FGRADE Concierge Team for a free consultation!

Call Us

+91 916 056 5554

Mail Us

sales@fgrade.com

Discover how Fgrade can streamline your business

Reach out to the FGRADE Concierge Team for a free consultation!

As a Zoho consulting partner, we specialize in tailoring business 

automation solutions to meet the unique needs of small and medium enterprises.

Search, compare & buy top business software with FGRADE. Find the best deals on Microsoft 365, Zoho, Google Workspace & more. Shop smart & save big!

AWFIS, Ground Floor, DSL abacus it park, Survey Colony, Industrial Development Area, Uppal, Hyderabad, Telangana 500039

Office Address

Quick Links

Call us: +91 916 056 5554

Mail us: sales@fgrade.com