All Toolkits

Zoho Mail

Latest version

Zoho Mail is a secure and ad-free email hosting platform with collaboration tools, calendar integration, and extensive administrative controls

Authentication DetailsComposio-managed OAuth available

Frequently Asked Questions

How do I set up custom OAuth credentials for Zoho Mail?

Use your own Zoho OAuth client when you want the consent screen to show your app name and to manage the client credentials yourself. You need an existing Zoho Mail account.

Create the Zoho OAuth client

  1. Sign in to the Zoho API Console. Click Add Client (or Get Started for your first client).

    Zoho API Console Applications list with the Add Client button

  2. Choose Server-based Applications and click Create Now. See Zoho's client registration guide.

    Zoho API Console client type picker with Server-based Applications

  3. Enter a Client Name and your application's Homepage URL. Use your own product name: Zoho rejects client names that contain ZOHO with "Client name should not contain ZOHO".

    Zoho API Console Create New Client form showing the "Client name should not contain ZOHO" error

  4. In Authorized Redirect URIs, enter https://backend.composio.dev/api/v1/auth-apps/add. It must exactly match the auth config's oauth_redirect_uri field.

    Zoho API Console Client Details tab with the Composio redirect URI saved

  5. Click Create, then open the Client Secret tab and copy the Client ID and Client Secret.

    Zoho API Console Client Secret tab with the Client ID and Client Secret (redacted)

Create the auth config in Composio

  1. In the Composio dashboard, go to Auth Configs → Create and select Zoho Mail.

    Composio Create Auth Config dialog with Zoho Mail selected

  2. Choose OAuth 2.0 and Your Own Credentials, then paste the Client ID and Client Secret. Leave Redirect URI as the value you registered in Zoho.

  3. Enter the scopes your workflow needs (see below) and click Create Auth Config. To add a scope that isn't listed, type its exact name and click Add scope.

    Zoho Mail auth config scope picker adding ZohoMail.accounts.READ by exact name

  4. Click Connect Account and enter the account's data center code in Domain Extension (see the region question below).

    Saved Zoho Mail auth config with the Connect Account button

    Composio Connect Account form with a data center code in Domain Extension

  5. Sign in to Zoho Mail, review the app name and permissions, tick the consent checkbox, and click Accept. Then open the auth config's Accounts tab and check that the account shows Active. The config showing Enabled doesn't mean an account is connected.

    Zoho consent screen asking to view mail account information

    Zoho Mail auth config Accounts tab with the connected account Active

See custom auth configs for the general flow.

Scopes

The default auth config requests no scopes, but Zoho requires scope names in the authorization request, so add the ones your tools need. Scope names are case-sensitive. Common ones:

  • ZohoMail.accounts.READ: list the user's mail accounts
  • ZohoMail.messages.READ: read messages
  • ZohoMail.messages.CREATE: send messages

See the Zoho Mail API reference for the scope each operation needs.

Troubleshooting

  • Invalid client or region error: check the client's data center, the account's data center, and Domain Extension.
  • Invalid scope: use the exact, case-sensitive Zoho Mail scope names.
  • Redirect mismatch: compare the full callback URL in Zoho and in Composio, including the path.
What should I pass for the correct Zoho region when connecting Zoho Mail?

Enter the code from your Zoho Mail web address in Domain Extension. Zoho accounts live in one data center, so an EU or other regional account fails if you connect with the default com.

  • mail.zoho.com: com
  • mail.zoho.eu: eu
  • mail.zoho.in: in
  • mail.zoho.com.au: au
  • mail.zohocloud.ca: ca
  • mail.zoho.com.cn: cn
  • mail.zoho.jp: jp
  • mail.zoho.ae: ae
  • mail.zoho.sa: sa

Enter the code only, not a full URL. If your app connects users in data centers other than the one where you registered the client, enable multi-DC support in the API Console. See Zoho's Mail data center list.