Compartilhar via


Vineforce

Trovve is an AI-powered project management tool that helps your team keep focused and on track, all inside Microsoft Teams.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   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)
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)
Contact
Name Contact
URL https://forms.office.com/r/fuRWvsztK2?origin=lprLink
Email help@Trovve.com
Connector Metadata
Publisher Vineforce, Inc
Website https://trovve.com/
Privacy policy https://trovve.com/trovve-legal-policy
Categories Collaboration;Productivity

Trovve Power Automate Connector makes it easy to automate processes in Trovve. You can connect productivity applications (like Outlook, SharePoint, Jira, and more) to Trovve and automatically create tasks or send alerts to Trovve App users based on a selected trigger. For example, when a user flags an email in Outlook, an automated workflow can instantly create a task in Trovve with a link to open the original email.

Prerequisites

You will need the following to proceed:

  • An account in the Trovve App, with admin permission to obtain the API key.
  • A Microsoft Power Automate account with the same credentials as your Trovve account.

How to get credentials

  • Sign up for Trovve App using this link.
  • Once successfully signed up, log in and navigate to the 'Company' tab then go to 'Settings'.
  • Take note of the API key as this will be used in the connector.

Get started with your connector

  1. Create a new flow in Power Automate
  2. Select any trigger from the list
  3. Choose the Trovve Connector for the Action
  4. Select any action from the list
  5. Use the API key from your Trovve app in populating the form.
  6. Populate any necessary details based on your specifications.
  7. Save and run the flow.

FAQ

  • Why is my connector not working as expected?

    • Make sure that your API key is correct.
  • Why am I not receiving a task from the flow that I created?

    • Make sure that the 'To Email' field is pointing to your email address used in Trovve App.
  • Why is my task not showing a 'Created By' entry in history tab?

    • Make sure that the value of the 'From Email' field is an existing user in Trovve App.
  • Is it necessary to specify the Resource App and its Resource URL?

    • No, but it is recommended as the link specified in your connector will natively be embedded in your task. This saves you from manually typing the link whenever you need to access it.

Support and Documentation

For any queries or if you need any assistance, please contact help@Trovve.com or visit support

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Alert

Alert

Create Company

Create a Trovve Company

Create Contact

Create a Trovve Contact

Create Contact Address

Create contact address

Create Contact Families

Create contact families

Create Contact Note

Create note for a contact

Create Contact Phone

Create contact phone

Create Project

Create project with sections, file links in Trovve App

Create Task

Create a new Trovve task.

Create Task Comment

Create Task Comment

Get Company Details

Get Company Details

Get Contact Folder Details

Get Contact Folder Details

Get Task By Resource App ID

Get Task By Resource App ID

Update Task

Update a task using the TaskID that is returned by Create Task Action.

Alert

Alert

Parameters

Name Key Required Type Description
Api key
apiKey True string

Api key

Alert To Email
alertToEmail True string

Alert To Email

Title
title True string

Title

Message
message True string

Message Text

Resource App
resourceName string

Resource App Name (Power Automate)

URL of Resource App
ResourceUrl string

URL of Resource App

Returns

Name Path Type Description
errorMessage
result.errorMessage string

errorMessage

message_Info
result.message_Info string

message_Info

isError
result.isError boolean

isError

errorType
result.errorType string

errorType

entityId
result.entityId string

entityId

longTypeEntityId
result.longTypeEntityId string

longTypeEntityId

fieldName
result.fieldName string

fieldName

targetUrl
targetUrl string

targetUrl

success
success boolean

success

error
error string

error

unAuthorizedRequest
unAuthorizedRequest boolean

unAuthorizedRequest

__abp
__abp boolean

__abp

Create Company

Create a Trovve Company

Parameters

Name Key Required Type Description
Api Key
apiKey True string

Api Key

Company Name
companyName True string

Company name

User Email
userEmail True string

Trovve user email

Street
street string

Street

Suite Unit Number
suite_UnitNumber string

Suite_UnitNumber

City
city string

City

State
state string

State

Postal Code
postalCode string

Postal code

Country Name
countryName string

Country name

Tax Id
taxId string

Tax Id

Site Url
siteUrl string

Site Url

Returns

Create Contact

Create a Trovve Contact

Parameters

Name Key Required Type Description
Api Key
apiKey True string

Api Key

User Email
ownerEmailAddress True string

Trovve user email

Email Address 1
contactEmailAddress1 True string

Contacts email address 1

Email Address 2
contactEmailAddress2 string

Contacts email address 2

Email Address 3
contactEmailAddress3 string

Contacts email address 3

First Name
firstName True string

First name

Last Name
lastName string

Last name

Job Title
jobTitle string

Job title

Birthdate (day)
birthDay string

Birthdate's day (1-31)

Birthdate (month)
birthMonth integer

Birthdate's month (1-12)

Birthdate (year)
birthYear integer

Birthdate's year (4 digits)

Contact Type
contactType string

Contact type

Company ID 1
companyID1 string

Company ID 1

Company ID 2
companyID2 string

Company ID 2

Company ID 3
companyID3 string

Company ID 3

Account Number
accountNumber string

Account number

Social Security Number
socialSecurityNumber string

Social security number

Returns

Name Path Type Description
statuscode
result.statuscode integer

statuscode

targetUrl
result.targetUrl string

targetUrl

success
result.success boolean

success

error
result.error string

error

unAuthorizedRequest
result.unAuthorizedRequest boolean

unAuthorizedRequest

__abp
result.__abp boolean

__abp

contactId
result.contactId string

contactId

targetUrl
targetUrl string

targetUrl

success
success boolean

success

error
error string

error

unAuthorizedRequest
unAuthorizedRequest boolean

unAuthorizedRequest

__abp
__abp boolean

__abp

Create Contact Address

Create contact address

Parameters

Name Key Required Type Description
Api Key
apiKey True string

Api Key

Contact Email
contactEmail True string

Contact email

User Email
userEmail True string

Trovve user email

Address Type
addressType True string

Address type

Street
street string

Street

Suite Unit Number
suiteUnitNumber string

Suite unit number

City
city string

City

State
state string

State

Zip Code
zipCode string

Zip code

Country Name
countryName string

Country name

Returns

Create Contact Families

Create contact families

Parameters

Name Key Required Type Description
Api Key
apiKey True string

Api Key

Contact Email
contactEmail True string

Contact email

User Email
userEmail True string

Trovve user email

First Name
firstName True string

First name

Last Name
lastName string

Last name

Relationship
relationship True string

Relationship

Birthdate (day)
birthDate string

Birthdate's day (1-31)

Birthdate (month)
birthMonth integer

Birthdate's month (1-12)

Birthdate (year)
birthYear integer

Birthdate's year (4 digits)

Country Name
countryName string

Country name

Returns

Create Contact Note

Create note for a contact

Parameters

Name Key Required Type Description
Api Key
apiKey True string

Api Key

User Email
ownerEmail True string

Trovve user email

Contact Email
contactEmail True string

Contact email

Notes
notes True string

Notes

Returns

Create Contact Phone

Create contact phone

Parameters

Name Key Required Type Description
Api Key
apiKey True string

Api Key

Contact Email
contactEmail True string

Contact email

User Email
userEmail True string

Trovve user email

Phone Number
phone True string

Phone number (Add country code infront if outside US)

Phone Type
phoneType True string

Phone type

Extension Number
extension string

Extension number

Returns

Create Project

Create project with sections, file links in Trovve App

Parameters

Name Key Required Type Description
API Key
apiKey True string

API Key assigned to company from Trovve App.

Project Name
projectName True string

Name of project to be created.

Creator Email
creatorEmail True string

Email of project creator.

Due Date
dueDate string

Due date of the project.

Members (Email)
members string

Separate each member's email using ";" semi colon.

Project Sections
sections string

Separate each section using ";" semi colon.

File Name
fileName string

Name of file with extension.

File Path
filePath string

Url link of file.

Returns

Name Path Type Description
statuscode
result.statuscode integer

statuscode

targetUrl
result.targetUrl string

targetUrl

success
result.success boolean

success

error
result.error string

error

unAuthorizedRequest
result.unAuthorizedRequest boolean

unAuthorizedRequest

__abp
result.__abp boolean

__abp

targetUrl
targetUrl string

targetUrl

success
success boolean

success

error
error string

error

unAuthorizedRequest
unAuthorizedRequest boolean

unAuthorizedRequest

__abp
__abp boolean

__abp

Create Task

Create a new Trovve task.

Parameters

Name Key Required Type Description
Api Key
apiKey True string

Api key

From Email
fromEmail string

Email address of user assigning this task

To Email
toEmail True string

Email address of assigned to user

Title
title True string

Title for the task

Description
description html

Description for the task

Start Date
startDate string

Start date of the task

Due Date
dueDate string

Due date of the task

Is task important?
isImportant boolean

Set task importance

Associated Contact Email
associatedContactEmail string

Email of contact to associate to this task

Resource App
resourceAppName string

Resource App Name (Power Automate)

Resource Url
resourceAppUrl string

Resource Url to bind with task

Resource App ID
ResourceAppID string

ID of resource to bind with task

Resource App Data
ResourceAppData string

Data of resource to bind with task

Project Name
projectName string

Project Name

Project Section
projectSectionName string

Project Section Name

Project Tags
projectTags string

Use comma ',' to separate tags

Title
name string

Title

Description
description string

Description

Name
fileName string

Name

Path
filePath string

Path

Type
fileType string

Type

Returns

Name Path Type Description
errorMessage
result.errorMessage string

errorMessage

message_Info
result.message_Info string

message_Info

isError
result.isError boolean

isError

taskID
result.taskID string

task ID

errorType
result.errorType string

errorType

entityId
result.entityId string

entityId

longTypeEntityId
result.longTypeEntityId string

longTypeEntityId

responseData
result.responseData integer

responseData

listOfEntities
result.listOfEntities string

listOfEntities

fieldName
result.fieldName string

fieldName

targetUrl
targetUrl string

targetUrl

success
success boolean

success

error
error string

error

unAuthorizedRequest
unAuthorizedRequest boolean

unAuthorizedRequest

__abp
__abp boolean

__abp

Create Task Comment

Create Task Comment

Parameters

Name Key Required Type Description
Api Key
apiKey True string

Api Key

User Email
userEmail True string

Trovve user email

Task ID
taskId True string

Encrypted ID of task

Comment
comment True string

Comment

Returns

Name Path Type Description
statuscode
result.statuscode integer

statuscode

targetUrl
result.targetUrl string

targetUrl

success
result.success boolean

success

error
result.error string

error

unAuthorizedRequest
result.unAuthorizedRequest boolean

unAuthorizedRequest

__abp
result.__abp boolean

__abp

Task Id
result.taskID string

Task Id encrypted

targetUrl
targetUrl string

targetUrl

success
success boolean

success

error
error string

error

unAuthorizedRequest
unAuthorizedRequest boolean

unAuthorizedRequest

__abp
__abp boolean

__abp

Get Company Details

Get Company Details

Parameters

Name Key Required Type Description
Api Key
ApiKey True string

Api key

Match By Value
MatchBy True string

Field to use to match value with

Match Value
MatchValue True string

Value to use to get Company

Returns

Name Path Type Description
statuscode
result.statuscode integer

statuscode

targetUrl
result.targetUrl string

targetUrl

success
result.success boolean

success

error
result.error string

error

unAuthorizedRequest
result.unAuthorizedRequest boolean

unAuthorizedRequest

__abp
result.__abp boolean

__abp

Company Id
result.companyId string

Company Id

Company Name
result.companyName string

Name of company

Street
result.street string

Street address

Suite / Unit Number
result.suiteUnitNumber string

Suite / Unit Number

City
result.city string

City address

State
result.state string

State address

Postal Code
result.postalCode string

Postal Code address

Country
result.country string

Country address

Tax ID
result.taxID string

Tax id

Folder Path
result.folderPath string

Company's folder link

Is a SharePoint folder
result.isSharePointDrive boolean

isSharePointDrive

targetUrl
targetUrl string

targetUrl

success
success boolean

success

error
error string

error

unAuthorizedRequest
unAuthorizedRequest boolean

unAuthorizedRequest

__abp
__abp boolean

__abp

Get Contact Folder Details

Get Contact Folder Details

Parameters

Name Key Required Type Description
Api Key
ApiKey True string

Api Key

Email address of user
UserEmail True string

Email address of user

Email address of contact
ContactEmail True string

Email address of contact

Returns

Name Path Type Description
statuscode
result.statuscode integer

statuscode

targetUrl
result.targetUrl string

targetUrl

success
result.success boolean

success

error
result.error string

error

unAuthorizedRequest
result.unAuthorizedRequest boolean

unAuthorizedRequest

__abp
result.__abp boolean

__abp

folderPath
result.folderPath string

folderPath

isSharePointDrive
result.isSharePointDrive boolean

isSharePointDrive

targetUrl
targetUrl string

targetUrl

success
success boolean

success

error
error string

error

unAuthorizedRequest
unAuthorizedRequest boolean

unAuthorizedRequest

__abp
__abp boolean

__abp

Get Task By Resource App ID

Get Task By Resource App ID

Parameters

Name Key Required Type Description
Api key
ApiKey True string

Api key

Resource app id linked to a task
ResourceAppID True string

Resource app id linked to a task

Returns

Name Path Type Description
statuscode
result.statuscode integer

statuscode

targetUrl
result.targetUrl string

targetUrl

success
result.success boolean

success

error
result.error string

error

unAuthorizedRequest
result.unAuthorizedRequest boolean

unAuthorizedRequest

__abp
result.__abp boolean

__abp

Task Id
result.taskID string

Task Id

Assignee Email
result.assigneeEmail string
Assignee Name
result.assigneeName string

Assignee Name

Title
result.title string

Title of task

Task Status
result.taskStatus string

Status of task

Description
result.description string

Description of task

Due Date
result.dueDate string

Due date of task

Country
result.country string

Country address

Is Important
result.isImportant boolean

Is marked important

Project Name
result.project string

Project name of the task

Project Section
result.projectSection string

Project section of the task

Associated Contact Email
result.assoContactEmail string
Associated Contact Name
result.assoContactName string

Associated contact name

targetUrl
targetUrl string

targetUrl

success
success boolean

success

error
error string

error

unAuthorizedRequest
unAuthorizedRequest boolean

unAuthorizedRequest

__abp
__abp boolean

__abp

Update Task

Update a task using the TaskID that is returned by Create Task Action.

Parameters

Name Key Required Type Description
Api Key
apiKey True string

Api key

Task ID
taskID True string

Task ID

From Email
fromEmail string

Email address of user assigning this task

To Email
toEmail True string

Email address of assigned to user

Set task status
TaskStatus string

Set task status

Title
title True string

Title for the task

Description
description html

Description for the task

Start Date
startDate string

Start date of the task

Due Date
dueDate string

Due Date for the task

Is task important?
isImportant boolean

Set task importance

Associated Contact Email
associatedContactEmail string

Email of contact to associate to this task

Resource App
resourceAppName string

Resource App Name (Power Automate)

Resource Url
resourceAppUrl string

Resource Url to bind with task

Resource App ID
ResourceAppID string

ID of resource to bind with task

Resource App Data
ResourceAppData string

Data of resource to bind with task

Project Name
projectName string

Project Name

Project Section
projectSectionName string

Project Section Name

Project Tags
projectTags string

Use comma ',' to separate tags

Title
name string

Title

Description
description string

Description

Name
fileName string

Name

Path
filePath string

Path

Type
fileType string

Type

Returns

Name Path Type Description
errorMessage
result.errorMessage string

errorMessage

message_Info
result.message_Info string

message_Info

isError
result.isError boolean

isError

taskID
result.taskID string

task ID

errorType
result.errorType string

errorType

entityId
result.entityId string

entityId

longTypeEntityId
result.longTypeEntityId string

longTypeEntityId

responseData
result.responseData integer

responseData

listOfEntities
result.listOfEntities string

listOfEntities

fieldName
result.fieldName string

fieldName

targetUrl
targetUrl string

targetUrl

success
success boolean

success

error
error string

error

unAuthorizedRequest
unAuthorizedRequest boolean

unAuthorizedRequest

__abp
__abp boolean

__abp