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 protected] |
| 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
- Create a new flow in Power Automate
- Select any trigger from the list
- Choose the Trovve Connector for the Action
- Select any action from the list
- Use the API key from your Trovve app in populating the form.
- Populate any necessary details based on your specifications.
- 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 [email protected] 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 |