Connect your Zoho Mail account to Goodweek to read, send, and manage emails directly from your AI workspace.
ℹ️ Governance note
Goodweek will never exceed the access levels granted to the user within Zoho Mail, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.
📋 Prerequisites
Before any user can see and connect the Zoho Mail integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.
Admin Setup
The Zoho Mail integration uses OAuth 2.0 and does not require any admin-level approval within Zoho before users can connect.
⚠️ Regional data centers
Zoho operates data centers in multiple regions (US, EU, AU, IN, JP). During the OAuth connection flow, make sure to sign in with the account associated with your correct regional data center.
User Connection
In Goodweek, go to Integrations.
Find Zoho Mail and click Connect.
You will be redirected to Zoho, where you will be asked to sign in and authorize access.
Click Accept to grant access and return to Goodweek.
Important Notes
Each user must connect their own account individually.
Goodweek can only access the emails and mail data associated with your individual Zoho Mail account.
You can revoke Goodweek's access at any time from Zoho Mail → Settings → Connected Apps → Composio → Revoke.
Available Tools
Tool | Description | Type |
List Zoho Mail Accounts | Retrieves all Zoho Mail accounts associated with the authenticated user. | Read |
List Emails | Retrieves a list of emails from a Zoho Mail account folder (e.g. inbox or a specified folder). | Read |
Get Message Content | Retrieves the full content and body of a specific Zoho Mail email by its ID. | Read |
Search Messages | Searches emails in a Zoho Mail account using Zoho's search syntax to find messages by sender, subject, keyword, or date. | Read |
Get All Bookmarks | Retrieves all personal bookmarks saved in a Zoho Mail account. | Read |
Send Email | Sends an email immediately via Zoho Mail to specified recipients. | Write |
Reply to Email | Sends a reply to an existing email message, maintaining the thread context. | Write |
Create Email Draft | Creates and saves an email draft in Zoho Mail without sending it. | Write |
Get Organization User Storage Details | Retrieves storage usage details for a specific user within the Zoho Mail organization. | Read |
Update User Storage | Updates a user's storage allocation within a Zoho Mail organization. | Write |
Update Organization Spam Process Type | Updates the spam filtering strategy for the Zoho Mail organization. | Write |
Update Group Settings | Updates settings for a Zoho Mail group. | Write |
Delete Groups in Bulk | Permanently deletes multiple Zoho Mail groups in a single API call. | ⚠️ Destructive |
Delete Group | Permanently deletes a specific Zoho Mail group by its ID. | ⚠️ Destructive |
Use Cases
Read and search emails from Goodweek. Retrieve emails from your inbox or search by sender, subject, or keyword directly from a Goodweek conversation, without opening Zoho Mail.
Send and reply to emails from conversations. Compose and send emails or reply to existing threads directly from Goodweek, keeping email communication in context with the work you're doing.
Draft emails for review before sending. Create email drafts in Zoho Mail through Goodweek to prepare communications in advance and send them at the right moment.
Monitor organization email storage. Retrieve storage usage details for users in the Zoho Mail organization to monitor capacity and manage allocations.
Troubleshooting
Connected but emails from the wrong account appear
Make sure you signed in with the Zoho account associated with your correct regional data center during the connection flow. Disconnect and reconnect if needed.
Integration not visible in Goodweek
Make sure your organization admin has enabled the Zoho Mail integration from the Goodweek Admin Panel under the Integrations tab.