Vineforce

Vineforce is a remote workplace tool built for Microsoft 365 users. It transforms the platform into one cohesive toolkit to help you get more done, experience less burnout, and feel more connected with your teammates.

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://www.vineforce.com/contact
Email	contact@vineforce.com

Connector Metadata
Publisher	Vineforce, Inc.
Website	https://www.vineforce.com
Privacy policy	https://www.vineforce.com/legal
Categories	Collaboration;Productivity

Vineforce Power Automate Connector makes it easy to automate processes in Vineforce. You can connect productivity applications (like Outlook, SharePoint, Jira, and more) to Vineforce and automatically create tasks or send alerts to Vineforce 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 Vineforce with a link to open the original email.

Prerequisites

You will need the following to proceed:

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

How to get credentials

• Sign up for Vineforce 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 Vineforce Connector for the Action
4. Select any action from the list
5. Use the API key from your Vineforce 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 Vineforce 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 Vineforce 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@vineforce.com or visit www.vineforce.com/help

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Alert	Alert
Create Company	Create a Vineforce Company
Create Contact	Create a Vineforce 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 Vineforce App
Create Task	Create a new Vineforce task.
Update Task	Update a task using the TaskID that is returned by Create Task Action.

Alert

Operation ID:

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	resourceAppName		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

Operation ID:

CreateCompany

Create a Vineforce 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	Vineforce 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

Operation ID:

CreateContact

Create a Vineforce Contact

Parameters

Name	Key	Required	Type	Description
Api Key	apiKey	True	string	Api Key
User Email	ownerEmailAddress	True	string	Vineforce 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

Operation ID:

CreateContactAddress

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	Vineforce 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

Operation ID:

CreateContactFamily

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	Vineforce 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

Operation ID:

CreateContactNote

Create note for a contact

Parameters

Name	Key	Required	Type	Description
Api Key	apiKey	True	string	Api Key
User Email	ownerEmail	True	string	Vineforce user email
Contact Email	contactEmail	True	string	Contact email
Notes	notes	True	string	Notes

Returns

Create contact Phone

Operation ID:

CreateContactPhone

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	Vineforce 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

Operation ID:

CreateProject

Create project with sections, file links in Vineforce App

Parameters

Name	Key	Required	Type	Description
API Key	apiKey	True	string	API Key assigned to company from Vineforce 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
ProjectId	result.ProjectId	string	ProjectId
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

Operation ID:

CreateTask

Create a new Vineforce 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
Due Date	dueDate		string	Due Date for the task
Is task important?	isImportant		boolean	Set task importance
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
Title	name		string	Title
Description	description		string	Description
Name	fileName		string	Name
Path	filePath		string	Path

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

Update Task

Operation ID:

UpdateTask

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
Due Date	dueDate		string	Due Date for the task
Is task important?	isImportant		boolean	Set task importance
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
Title	name		string	Title
Description	description		string	Description
Name	fileName		string	Name
Path	filePath		string	Path

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