← IMAP + Zoho Projects integrations

Upload File with Zoho Projects API on New Email from IMAP API

Pipedream makes it easy to connect APIs for Zoho Projects, IMAP and 2,400+ other apps remarkably fast.

Trigger workflow on
New Email from the IMAP API
Next, do this
Upload File with the Zoho Projects API
No credit card required
Intro to Pipedream
Watch us build a workflow
Watch us build a workflow
8 min
Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo
Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo

Developers Pipedream

Getting Started

This integration creates a workflow with a IMAP trigger and Zoho Projects action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

  1. Select this integration
  2. Configure the New Email trigger
    1. Connect your IMAP account
    2. Configure Polling interval
    3. Select a Mailbox
  3. Configure the Upload File action
    1. Connect your Zoho Projects account
    2. Select a Portal ID
    3. Select a Project ID
    4. Select a Third Party Folder ID
    5. Configure Folder Name
    6. Configure Folder Include Files
    7. Configure File Document
  4. Deploy the workflow
  5. Send a test event to validate your setup
  6. Turn on the trigger

Details

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger

Description:Emit new event for each new email in a mailbox
Version:0.0.4
Key:imap-new-email

IMAP Overview

Using Pipedream's IMAP API, developers can automate interactions with their email inbox, enabling serverless workflows that perform actions based on incoming emails. This could include parsing email contents, triggering events upon receiving emails from specific senders, attaching labels, and much more. By leveraging IMAP, Pipedream can act as a bridge between your email and other services, streamlining processes that would otherwise require manual intervention.

Trigger Code

import imap from "../../imap.app.mjs";
import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";

/**
 * Creates an IMAP server connection and emits emails added to a mailbox after the last emitted
 * email.
 */
export default {
  key: "imap-new-email",
  name: "New Email",
  description: "Emit new event for each new email in a mailbox",
  version: "0.0.4",
  type: "source",
  dedupe: "unique",
  props: {
    imap,
    db: "$.service.db",
    timer: {
      label: "Polling interval",
      description:
        "Pipedream will poll the IMAP server for new emails at this interval",
      type: "$.interface.timer",
      default: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
    mailbox: {
      propDefinition: [
        imap,
        "mailbox",
      ],
    },
  },
  methods: {
    _getLastUid(mailbox) {
      return this.db.get(`lastUid-${mailbox}`);
    },
    _setLastUid(mailbox, lastUid) {
      this.db.set(`lastUid-${mailbox}`, lastUid);
    },
    _getUidValidity(mailbox) {
      return this.db.get(`uidValidity-${mailbox}`);
    },
    _setUidValidity(mailbox, uidValidity) {
      this.db.set(`uidValidity-${mailbox}`, uidValidity);
    },
    _handleUidValidityChange(mailbox, uidValidity) {
      this._setUidValidity(mailbox, uidValidity);
      this._setLastUid(mailbox, null);
    },
    hasNewMessages(box) {
      const lastUid = this._getLastUid(box.name);
      return !lastUid || box.uidnext > lastUid + 1;
    },
    generateMeta(message) {
      const date = message.attributes?.date ?? new Date();
      const ts = Date.parse(date);
      return {
        id: `${message.attributes?.uid}-${ts}`,
        ts,
        summary: message.mail?.subject,
      };
    },
    processMessage(message) {
      const lastUid = message.attributes?.uid ?? lastUid;
      this._setLastUid(this.mailbox, lastUid);
      this.$emit(message.mail, this.generateMeta(message));
    },
    async processMessageStream(stream) {
      for await (const message of stream) {
        this.processMessage(message);
      }
    },
    async getHistoricalEvents() {
      const { mailbox } = this;
      const connection = await this.imap.getConnection();
      try {
        const box = await this.imap.openMailbox(connection, mailbox);
        const startSeqno = box.messages.total > 25
          ? box.messages.total - 24
          : 1;
        const messageStream = this.imap.fetchMessages(connection, {
          startSeqno,
        });
        await this.processMessageStream(messageStream);
      } finally {
        await this.imap.closeConnection(connection);
      }
    },
  },
  hooks: {
    async deploy() {
      await this.getHistoricalEvents();
    },
  },
  async run() {
    const { mailbox } = this;
    const connection = await this.imap.getConnection();

    try {
      const box = await this.imap.openMailbox(connection, mailbox);

      const uidValidity = this._getUidValidity(box.name);
      if (uidValidity !== box.uidvalidity) {
        this._handleUidValidityChange(box.name, box.uidvalidity);
      }

      if (!this.hasNewMessages(box)) {
        console.log("No new messages since last run");
        return;
      }

      const lastUid = this._getLastUid(box.name);

      // Fetch messages after lastUid if it exists, or most recent message otherwise
      const messageStream = this.imap.fetchMessages(connection, {
        startUid: lastUid && lastUid + 1,
        startSeqno: box.messages.total,
      });
      await this.processMessageStream(messageStream);
    } finally {
      await this.imap.closeConnection(connection);
    }
  },
};

Trigger Configuration

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.
LabelPropTypeDescription
IMAPimapappThis component uses the IMAP app.
N/Adb$.service.dbThis component uses $.service.db to maintain state between executions.
Polling intervaltimer$.interface.timer

Pipedream will poll the IMAP server for new emails at this interval

MailboxmailboxstringSelect a value from the drop down menu.

Trigger Authentication

IMAP uses API keys for authentication. When you connect your IMAP account, Pipedream securely stores the keys so you can easily authenticate to IMAP APIs in both code and no-code steps.

Below are the required fields to connect your IMAP account to Pipedream:

  • host: Enter the host Pipedream should connect to. Refer to your email provider's IMAP instructions if you aren't sure what to enter.
  • email: Enter the email address you use to sign in to the account you'd like to connect.
  • password: This is the password you use to sign in to your email account. Note: in order to connect a Gmail account, you must use an App Password.
  • port: Specify the port number, either 143 (default) or 993. Refer to your email provider's IMAP instructions if you aren't sure which to use.

For Gmail accounts, refer to these instructions.

About IMAP

Connect Pipedream to any IMAP email provider to trigger custom workflows.

Action

Description:Add a document. [See the docs here](https://www.zoho.com/projects/help/rest-api/documents-api.html#alink3)
Version:0.0.2
Key:zoho_projects-upload-file

Zoho Projects Overview

The Zoho Projects API lets you harness the full potential of project management by enabling seamless integration with other tools and automating routine tasks. With it, you can create projects, manage tasks, track time, and customize your workflow. On Pipedream, you can leverage this API to build robust automations that connect Zoho Projects with a plethora of other apps, streamlining project tracking and collaboration workflows, all without writing a single line of code.

Action Code

import zohoProjects from "../../zoho_projects.app.mjs";
import constants from "../../common/constants.mjs";

export default {
  key: "zoho_projects-upload-file",
  name: "Upload File",
  description: "Add a document. [See the docs here](https://www.zoho.com/projects/help/rest-api/documents-api.html#alink3)",
  type: "action",
  version: "0.0.2",
  props: {
    zohoProjects,
    portalId: {
      propDefinition: [
        zohoProjects,
        "portalId",
      ],
    },
    projectId: {
      propDefinition: [
        zohoProjects,
        "projectId",
        ({ portalId }) => ({
          portalId,
        }),
      ],
    },
    folderId: {
      propDefinition: [
        zohoProjects,
        "folderId",
        ({
          portalId, projectId,
        }) => ({
          portalId,
          projectId,
        }),
      ],
    },
    folderName: {
      type: "string",
      label: "Folder Name",
      description: "Name of the folder to create.",
    },
    folderIncludeFiles: {
      type: "boolean",
      label: "Folder Include Files",
      description: "If `true`, the new folder will become the parent folder for the files instead of the one in the URL by default",
      default: true,
    },
    uploadFile: {
      type: "string",
      label: "File Document",
      description: "File path of a file previously downloaded in Pipedream E.g. (`/tmp/my-file.txt`). [Download a file to the `/tmp` directory](https://pipedream.com/docs/code/nodejs/http-requests/#download-a-file-to-the-tmp-directory)",
    },
  },
  async run({ $ }) {
    const {
      portalId,
      folderId,
      folderName,
      folderIncludeFiles,
      uploadFile,
    } = this;

    const response =
      await this.zohoProjects.uploadFiles({
        $,
        headers: constants.MULTIPART_FORM_DATA_HEADERS,
        portalId,
        folderId,
        data: {
          service: "workdrive",
          folder_name: folderName,
          folder_include_files: folderIncludeFiles,
          upload_file: uploadFile,
        },
      });

    $.export("$summary", "Successfully uploaded a file to the project");

    return response;
  },
};

Action Configuration

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

LabelPropTypeDescription
Zoho ProjectszohoProjectsappThis component uses the Zoho Projects app.
Portal IDportalIdstringSelect a value from the drop down menu.
Project IDprojectIdstringSelect a value from the drop down menu.
Third Party Folder IDfolderIdstringSelect a value from the drop down menu.
Folder NamefolderNamestring

Name of the folder to create.

Folder Include FilesfolderIncludeFilesboolean

If true, the new folder will become the parent folder for the files instead of the one in the URL by default

File DocumentuploadFilestring

File path of a file previously downloaded in Pipedream E.g. (/tmp/my-file.txt). Download a file to the /tmp directory

Action Authentication

Zoho Projects uses OAuth authentication. When you connect your Zoho Projects account, Pipedream will open a popup window where you can sign into Zoho Projects and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Zoho Projects API.

Pipedream requests the following authorization scopes when you connect your account:

ZohoProjects.portals.allZohoProjects.projects.allZohoProjects.activities.createZohoProjects.status.readZohoProjects.milestones.allZohoProjects.tasklists.allZohoProjects.tasks.allZohoProjects.timesheets.allZohoProjects.bugs.allZohoProjects.tags.allZohoProjects.events.allZohoProjects.forums.allZohoProjects.users.allZohoProjects.documents.CREATEZohoPC.files.CREATEZohoProjects.search.readZohoProjects.documents.READWorkDrive.team.ALLWorkDrive.workspace.ALLWorkDrive.files.ALL

About Zoho Projects

Online Project Management Software & Tools

More Ways to Connect Zoho Projects + IMAP

Create Bug with Zoho Projects API on New Email from IMAP API
IMAP + Zoho Projects
 
Try it
Add Log Time with Zoho Projects API on New Email from IMAP API
IMAP + Zoho Projects
 
Try it
Create Milestone with Zoho Projects API on New Email from IMAP API
IMAP + Zoho Projects
 
Try it
Create Task with Zoho Projects API on New Email from IMAP API
IMAP + Zoho Projects
 
Try it
Create Project with Zoho Projects API on New Email from IMAP API
IMAP + Zoho Projects
 
Try it
New Email from the IMAP API

Emit new event for each new email in a mailbox

 
Try it
New Bug from the Zoho Projects API

Emit new event when a new bug is created. See the docs here

 
Try it
New Log Time from the Zoho Projects API

Emit new event when a log time is created. See the docs here

 
Try it
New Milestone from the Zoho Projects API

Emit new event when a new milestone is created. See the docs here

 
Try it
New Project from the Zoho Projects API

Emit new event when a new project is created. See the docs here

 
Try it
Add Log Time with the Zoho Projects API

Add Time for a General Log. Adds the time log to other tasks. See the docs here

 
Try it
Create Bug with the Zoho Projects API

Creates a bug. See the docs here

 
Try it
Create Milestone with the Zoho Projects API

Creates a milestone. See the docs here

 
Try it
Create Project with the Zoho Projects API

Creates a project. See the docs here

 
Try it
Create Task with the Zoho Projects API

Creates a task. See the docs here

 
Try it

Explore Other Apps

1
-
24
of
2,400+
apps by most popular

HTTP / Webhook
HTTP / Webhook
Get a unique URL where you can send HTTP or webhook requests
Node
Node
Anything you can do with Node.js, you can do in a Pipedream workflow. This includes using most of npm's 400,000+ packages.
Python
Python
Anything you can do in Python can be done in a Pipedream Workflow. This includes using any of the 350,000+ PyPi packages available in your Python powered workflows.
OpenAI (ChatGPT)
OpenAI (ChatGPT)
OpenAI is an AI research and deployment company with the mission to ensure that artificial general intelligence benefits all of humanity. They are the makers of popular models like ChatGPT, DALL-E, and Whisper.
Premium
Salesforce
Salesforce
Web services API for interacting with Salesforce
Premium
HubSpot
HubSpot
HubSpot's CRM platform contains the marketing, sales, service, operations, and website-building software you need to grow your business.
Premium
Zoho CRM
Zoho CRM
Zoho CRM is an online Sales CRM software that manages your sales, marketing, and support in one CRM platform.
Premium
Stripe
Stripe
Stripe powers online and in-person payment processing and financial solutions for businesses of all sizes.
Shopify
Shopify
Shopify is a complete commerce platform that lets anyone start, manage, and grow a business. You can use Shopify to build an online store, manage sales, market to customers, and accept payments in digital and physical locations.
Premium
WooCommerce
WooCommerce
WooCommerce is the open-source ecommerce platform for WordPress.
Premium
Snowflake
Snowflake
A data warehouse built for the cloud
Premium
MongoDB
MongoDB
MongoDB is an open source NoSQL database management program.
Supabase
Supabase
Supabase is an open source Firebase alternative.
MySQL
MySQL
MySQL is an open-source relational database management system.
PostgreSQL
PostgreSQL
PostgreSQL is a free and open-source relational database management system emphasizing extensibility and SQL compliance.
Premium
AWS
AWS
Amazon Web Services (AWS) offers reliable, scalable, and inexpensive cloud computing services.
Premium
Twilio SendGrid
Twilio SendGrid
Send marketing and transactional email through the Twilio SendGrid platform with the Email API, proprietary mail transfer agent, and infrastructure for scalable delivery.
Amazon SES
Amazon SES
Amazon SES is a cloud-based email service provider that can integrate into any application for high volume email automation
Premium
Klaviyo
Klaviyo
Email Marketing and SMS Marketing Platform
Premium
Zendesk
Zendesk
Zendesk is award-winning customer service software trusted by 200K+ customers. Make customers happy via text, mobile, phone, email, live chat, social media.
Notion
Notion
Notion is a new tool that blends your everyday work apps into one. It's the all-in-one workspace for you and your team.
Slack
Slack
Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work — all within a secure, enterprise-grade environment.
Microsoft Teams
Microsoft Teams
Microsoft Teams has communities, events, chats, channels, meetings, storage, tasks, and calendars in one place.
Schedule
Schedule
Trigger workflows on an interval or cron schedule.