Share via

Zoho TeamInbox (Preview)

The Zoho TeamInbox connector allows you to perform actions such as creating and saving contacts, as well as receiving, searching, archiving, and deleting emails within your shared inboxes based on email ID, sender address, subject line, or email content.

This connector is available in the following products and regions:

Service Class Regions
Copilot Studio Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Zoho TeamInbox
URL https://www.zoho.com/teaminbox/contact.html?src=pd-menu
Email support@zohoteaminbox.com
Connector Metadata
Publisher Zoho Corporation Private Limited
Website https://www.zoho.com/teaminbox/
Privacy policy https://www.zoho.com/privacy.html
Categories Communication

Zoho TeamInbox

The Zoho TeamInbox connector allows you to perform actions such as creating and saving contacts, as well as receiving, searching, archiving, and deleting emails within your shared inboxes based on email ID, sender address, subject line, or email content.

Prerequisites

A verified Zoho TeamInbox account. Click [here] (https://www.zoho.com/teaminbox/signup.html) to create your first account.

How to get credentials

When you create a new connection,

  1. Select the domain where your Zoho account resides.
  2. Enter your TeamInbox's credentials.
  3. Even if the power app is shared with another user, they should create a new connection to start using it.

Get started with your connector

Follow the steps below to connect to TeamInbox :

  1. Login to your Power Automate account and click Create from the left menu.
  2. You can choose to create a cloud flow, desktop flow or business flow. To connect to TeamInbox, choose the automated cloud flow.
  3. You can create a flow in three ways :
    • Create a custom flow by starting from blank.
    • Choosing from available templates.
    • Choosing to start from a connector.
  4. Click on Automated cloud flow from the start from blank to create a connection from scratch.
  5. Enter the desired values, choose the required parameters.
  6. Click save. The flow will automatically be executed.

Known issues and limitations

The total email size, including the email headers, body content, inline images, and attachments should not exceed the plan limit.

Zoho TeamInbox cannot be used for sending out bulk emails and other emails that violates Zoho TeamInbox usage policy.

Common errors and remedies

To avoid authentication errors, choose the domain where your TeamInbox account is hosted.

FAQ

https://help.zoho.com/portal/en/kb/teaminbox/help

Creating a connection

The connector supports the following authentication types:
Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
Select the region where your Zoho account data resides. string Select the domain. True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Archive a thread

Move a conversation or email thread into the archive folder for record-keeping.
Assign a thread

Assign ownership of a conversation or email thread to a specific team member.
Create contact

Create a new contact under the team, with the name, email address and phone number.
Follow a Thread

Follow to get all notification of the thread
Search email

Search emails in a inbox filtered by subject or keyword
Send email

Compose and send a new email
Trash a thread

Move a conversation or email thread to the trash, marking it for deletion.

Archive a thread

Operation ID:
Archive_Thread

Move a conversation or email thread into the archive folder for record-keeping.

Parameters

Name Key Required Type Description
Organization
 workspace_id True string

Choose an organisation from the list or enter the organisation’s unique ID.
Team
 team_id True string

Select a team or enter the team's unique ID.
Inbox
 inbox_id True string

Select an inbox or enter the inbox's unique ID.
Thread
 conversation_id True string

Select the thread or enter the thread's unique ID to archive
Channel
 entity_type True integer

Select the channel type for the message.

Returns

Name Path Type Description
Response code
 status.code integer

Response code generated for the request
Description
 status.description string

Response status description of the request.

Assign a thread

Operation ID:
Assign_Thread

Assign ownership of a conversation or email thread to a specific team member.

Parameters

Name Key Required Type Description
Organization
 workspace_id True string

Select an organization or enter the organization’s unique ID.
Team
 team_id True string

Select a team or enter the team's unique ID
Inbox
 inbox_id True string

Select a inbox or enter the inbox's unique ID
Thread
 conversation_id True string

Select a thread or enter the thread's unique ID to whom the thread will be assigned.
Assignee
 assignee True string

Select member or enter member's unique ID to assign
Channel
 entity_type True integer

Select the channel type for the message.

Returns

Name Path Type Description
Response code
 status.code integer

Response code generated for the request
Description
 status.description string

Response status description of the request.

Create contact

Operation ID:
Create_Contact

Create a new contact under the team, with the name, email address and phone number.

Parameters

Name Key Required Type Description
Organisation
 workspace_id True string

Select an organization or enter the organization’s unique ID.
Team
 team_id True string

Select a team or enter the team's unique ID.
Contact name
 name True string

Enter contact's name
Contact email
 email_id string

Enter contact's email
Contact description
 description string

Enter contact's description
Contact mobile number
 mobile string

Enter contact's mobile number
Facebook
 facebook_profile_url string

Enter your contact's Facebook account URL
Instagram
 instagram_profile_url string

Enter your contact's Instagram account URL

Returns

Name Path Type Description
Contact ID
 data.contact_id string

Unique ID of the contact

Follow a Thread

Operation ID:
Follow_Conversation

Follow to get all notification of the thread

Parameters

Name Key Required Type Description
Organization
 workspace_id True string

Select an organization or enter the organization’s unique ID.
Team
 team_id True string

Select a team or enter the team's unique ID.
Inbox
 inbox_id True string

Select an inbox or enter the inbox's unique ID.
Thread
 conversation_id True string

Select a thread or enter the thread's unique ID to follow.
Channel
 entity_type True integer

Select the channel type for the message.

Returns

Name Path Type Description
Response code
 status.code integer

Response code generated for the request
Description
 status.description string

Response status description of the request.

Search email

Operation ID:
Search_Mail

Search emails in a inbox filtered by subject or keyword

Parameters

Name Key Required Type Description
Organization
 workspace_id True string

Select an organization or enter the organization’s unique ID.
Contains
 contains string

Enter the text to search the message
Subject
 subject string

Enter the subject of the message to search
Include trash
 is_trashed boolean

indicates whether trash message is included
Include spam
 is_spam boolean

indicates whether spam message is included

Returns

Name Path Type Description
messages
 data.messages array of object

list of messages
Message subject
 data.messages.subject string

subject of the message
Channel type
 data.messages.type string

Type of channel associated with the message
Archived status
 data.messages.archived boolean

Indicates whether the message is archived.
Created time
 data.messages.createdTime string

Timestamp when the message was created.
From
 data.messages.from string

Sender of the message.
Summary
 data.messages.summary string

Summary of the message content.
Read status
 data.messages.read boolean

Read status of the message.
Total thread count
 data.messages.threadCount integer

Total thread count of the message.
Thread ID
 data.messages.entityId string

unique ID of the message
Team ID
 data.messages.teamId string

Unique ID of the team associated of the message.
Following status
 data.messages.following boolean

Indicates whether the user is following this message thread.
Spam status
 data.messages.spam boolean

Spam classification status of the message.
Inbox ID
 data.messages.inboxId string

Unique ID of the inbox associated with the message
Draft status
 data.messages.drafted boolean

Indicates whether the message is saved as draft.
Trash status
 data.messages.trashed boolean

Indicates whether the message is trashed

Send email

Operation ID:
Send_Mail

Compose and send a new email

Parameters

Name Key Required Type Description
Organization
 workspace_id True string

Select an organization or enter the organization’s unique ID.
Team
 team_id True string

Choose a team or enter the team ID.
Inbox
 teaminbox_id True string

Choose an inbox or specify the inbox ID
From
 fromAddress True string

Select or enter sender email address
To
 toAddress True string

Enter comma-separated To email addresses
CC
 ccAddress string

Enter comma-separated CC email addresses
BCC
 bccAddress string

Enter comma-separated BCC email addresses
Email subject
 subject True string

Enter subject line
Email body
 text html

Enter email content
Archive
 archive True boolean

send and archive the mail

Returns

Name Path Type Description
Message ID
 data.messageId string

Unique ID of email within a thread
Entity ID
 data.entityId string

Unique thread ID associated with the message
Channel type
 data.type string

Type of channel associated with the message
Priority
 data.tdetails.PRIORITY integer

Priority of the message
From
 data.tdetails.FROM string

Sender of the message.
Email content
 data.tdetails.CONTENT string

content of the mail
CC
 data.tdetails.CC string

CC email address
BCC
 data.tdetails.BCC string

BCC email address
Sent time
 data.tdetails.SENTTIMEINMILLIS string

The time when the thread or message was created in the system
Subject
 data.tdetails.SUBJECT string

subject of the mail
To
 data.tdetails.TO string

recipient email addresses
Archived thread
 data.archived boolean

The thread is archived
following
 data.following boolean

following
Team ID
 data.teamId string

The ID of the inbox from where the mail is sent.
Created Time
 data.createdTime string

The time when the thread or message was created in the system
From address
 data.from string

The original detail of the email, including the sender’s address.
Assignee
 data.assignee string

The assigned team member responsible for handling the thread.
Inbox ID
 data.inboxId string

The ID of the inbox from where the mail is sent.
Channel ID
 data.channelId string

The ID of the channel associated with the message or thread.
code
 status.code integer

code

Trash a thread

Operation ID:
Trash_Conversation

Move a conversation or email thread to the trash, marking it for deletion.

Parameters

Name Key Required Type Description
Organisation
 workspace_id True string

Select an organization or enter the organization’s unique ID.
Team
 team_id True string

Select a team or enter the team's unique ID.
Inbox
 inbox_id True string

Select an inbox or enter the inbox's unique ID.
Thread
 conversation_id True string

Select a thread or enter the thread's unique ID to trash.
Channel
 entity_type True integer

Select the channel type for the message.

Returns

Name Path Type Description
Response code
 status.code integer

Response code generated for the request
Description
 status.description string

Response status description of the request.