Teamflect (Preview)
Enhance your workflow efficiency with the Teamflect. Seamlessly integrate Teamflect’s robust performance management features, including goals, feedback, and reviews, into your existing ecosystem. Automate routine tasks, synchronize data across platforms, and create dynamic, data-driven workflows to boost productivity and engagement across your organization.
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) |
| Contact | |
|---|---|
| Name | Bora Unlu |
| URL | https://teamflect.com/contact-us |
| support@teamflect.com |
| Connector Metadata | |
|---|---|
| Publisher | Teamflect |
| Website | https://teamflect.com |
| Privacy policy | https://teamflect.com/privacy |
| Categories | Business Management |
Teamflect Power Automate Connector
Note: This is a custom connector provided to integrate Teamflect's extensive APIs into your automated workflows in Power Automate and Power Apps.
The Teamflect Power Automate Connector allows you to manage and interact with goals, feedback, recognitions, and tasks directly from your automated workflows. By leveraging this connector, users can streamline their performance management processes by integrating them seamlessly with Microsoft Power Automate.
Prerequisites
To use this connector, you will need the following:
A Microsoft Power Apps or Power Automate Plan that includes support for custom connectors.
A Teamflect Account with the necessary API permissions to access the relevant data.
Power Platform CLI Tools to build and deploy the connector.
Building the Connector
Teamflect APIs are secured via API keys. To access the APIs through this connector, you'll need to obtain your Teamflect API key and configure it securely within Power Automate.
Steps to Build and Configure the Connector:
Obtain an API Key:
Log in to your Teamflect account and navigate to the API settings page.
Generate an API key and keep it securely. You will need to use this key while configuring the connector.
Download Connector Files:
- Ensure you have the API definition (OpenAPI/Swagger file) for the Teamflect API. This file defines the operations and data structure supported by the connector.
Deploy the Connector:
Use the Power Platform CLI to deploy the connector.
Run the following command to create the connector:
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <api_key>
Test the Connector:
- Once deployed, test the connector by creating a Power Automate flow using any of the supported operations.
Supported Operations
The Teamflect Connector supports the following operations:
Feedback Management
Send Feedback Request: Initiate a feedback request for a specified user.
Send External Feedback Request: Send a feedback request to an external email address.
Goal Management
Get Goal by ID: Retrieve details of a specific goal.
Get Goals: List multiple goals based on search criteria.
Create New Goal: Create a new goal for a user.
Update Goal Progress: Update the progress or status of a goal.
Comment on Goal: Add a comment to a goal.
Recognitions
Create Recognition: Create a new recognition for one or more users.
Get Recognition by ID: Retrieve details of a specific recognition.
Get Recognitions: List multiple recognitions.
Task Management
Get Task by ID: Retrieve a task by its unique identifier.
Get Tasks: List tasks based on search criteria.
Deployment Notes
Ensure that your API key is stored securely and is not shared publicly.
Use the connector responsibly to avoid hitting API rate limits.
Refer to the Teamflect API Documentation for detailed information about the API, including error codes and additional parameters.
Additional Information
For more details about the Teamflect platform, visit our website. If you encounter any issues or need assistance, please contact our support team at support@teamflect.com.
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 |
|---|---|---|---|
| API Key | securestring | The API Key for this api | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Adds a comment to a goal |
Adds a new comment to a goal |
| Creates a new goal |
Creates a new goal |
| Creates a new recognition |
Creates a new recognition |
| Gets a goal by ID |
Gets a goal by ID |
| Gets a recognition by ID |
Gets a recognition by ID |
| Gets a task by ID |
Gets a task by ID |
| Gets a user by mail |
Gets a user by mail |
| Returns goals based on the filters applied |
Returns goals based on the filters applied |
| Returns tasks based on the filters applied |
Returns tasks based on the filters applied |
| Returns the recognitions based on the filters applied |
Returns the recognitions based on the filters applied |
| Sends a new external feedback request |
Sends a new external feedback request |
| Sends a new feedback request |
Sends a new feedback request. |
| Update the progress of a goal |
Update the progress of a goal |
| Updates a user with selected attributes |
Updates the attributes of a user |
Adds a comment to a goal
Adds a new comment to a goal
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Id of the goal
|
goalId | True | string |
Id of the goal |
|
Object Id or User principal name of the commenter
|
commenterIdOrUPN | True | string |
Object Id or User principal name of the commenter |
|
Comment itself
|
commentText | True | string |
Comment itself |
Returns
- Body
- Goal
Creates a new goal
Creates a new goal
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Goal Title
|
title | True | string |
Title of the new goal |
|
Description
|
description | True | string |
Detailed description of the new goal |
|
Start Date
|
startDate | True | string |
Date when the goal should start |
|
Due Date
|
dueDate | True | string |
Date when the goal should be completed |
|
Goal Type
|
goalType | True | string |
Type of the goal |
|
Goal Owner
|
goalOwnerUPNorId | True |
Email or ID of the goal owner |
|
|
Goal Creator
|
goalCreatorUPNorId | True | string |
Email or ID of the goal creator |
|
Is Private
|
isPrivate | True | boolean |
Whether the goal should be private |
|
Progress Format
|
progressFormatType | True | string |
Format type for tracking progress |
|
Currency Code
|
currencyCode | True | string |
Currency code for monetary goals |
|
Initial Value
|
initialValue | True | number |
Initial progress value |
|
Target Value
|
targetValue | True | number |
Target progress value |
|
Parent Goal ID
|
parentGoalId | True | string |
ID of the parent goal if this is a sub-goal |
|
Notify Owner
|
sendNotificationToOwner | True | boolean |
Whether to notify the goal owner |
Returns
- Body
- Goal
Creates a new recognition
Creates a new recognition
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Recognition Sender
|
senderIdOrUPN | True | string |
Email or ID of the person sending the recognition |
|
Recognition Recipients
|
recipientsIdsOrUPNS | True | array of string |
List of emails or IDs of people receiving the recognition |
|
Badge Title
|
badgeTitle | True | string |
Title of the recognition badge |
|
Is Private
|
isPrivate | True | boolean |
Whether the recognition is private |
|
Recognition Message
|
description | True | string |
Message included with the recognition |
Returns
Gets a goal by ID
Gets a goal by ID
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Goal ID
|
goalId | True | string |
Unique identifier of the goal to retrieve |
Returns
- Body
- Goal
Gets a recognition by ID
Gets a recognition by ID
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Recognition ID
|
recognitionId | True | string |
Unique identifier of the recognition to retrieve |
Returns
- Body
- RecognitionResponse
Gets a task by ID
Gets a task by ID
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Task ID
|
taskId | True | string |
Unique identifier of the task to retrieve |
Returns
- Body
- Task
Gets a user by mail
Gets a user by mail
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User Email
|
userMail | True | string |
Email address of the user to retrieve |
Returns
- Body
- User
Returns goals based on the filters applied
Returns goals based on the filters applied
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User Object ID
|
userOID | string |
Object ID of the user whose goals to retrieve |
|
|
User Email
|
userUPN | string |
User Principal Name (email) of the user whose goals to retrieve |
|
|
Search Text
|
search | string |
Text to search for in goal titles and descriptions |
|
|
Goal Labels
|
selectedLabels | string |
Labels to filter goals by |
|
|
Result Limit
|
limit | string |
Maximum number of goals to return |
|
|
Skip Count
|
skip | string |
Number of goals to skip for pagination |
|
|
Start Date
|
startDate | string |
Start date for filtering goals |
|
|
End Date
|
endDate | string |
End date for filtering goals |
Returns
- Items
- Goals
Returns tasks based on the filters applied
Returns tasks based on the filters applied
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User Object ID
|
userOID | string |
Object ID of the user whose tasks to retrieve |
|
|
User Email
|
userUPN | string |
User Principal Name (email) of the user whose tasks to retrieve |
|
|
Search Text
|
search | string |
Text to search for in task titles and descriptions |
|
|
Result Limit
|
limit | number |
Maximum number of tasks to return |
|
|
Skip Count
|
skip | number |
Number of tasks to skip for pagination |
|
|
Start Date
|
startDate | string |
Start date for filtering tasks |
|
|
End Date
|
endDate | string |
End date for filtering tasks |
Returns
- Items
- Tasks
Returns the recognitions based on the filters applied
Returns the recognitions based on the filters applied
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Recipients to Search
|
recipientsIdsOrUPNS | True | array of string |
List of recipient emails or IDs to search for |
|
Recognition Title
|
title | True | string |
Recognition title to search for |
|
Update Date
|
updated | True | string |
Last update date to filter by |
|
Creation Date
|
created | True | string |
Creation date to filter by |
Returns
- Items
- RecognitionResponses
Sends a new external feedback request
Sends a new external feedback request
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Feedback Subject
|
feedbackAboutUPNorId | True | string |
Email or ID of the person receiving feedback |
|
External Email
|
externalEmail | True | string |
Email address of the external feedback provider |
|
Provider Name
|
onBehalfName | True | string |
Name to display for the external feedback provider |
|
Request Note
|
feedbackNote | True | string |
Note to include with the feedback request |
|
Template Title
|
templateTitle | True | string |
Title of the feedback template to use |
|
Due Days
|
dueDateInDays | True | number |
Number of days until the feedback is due |
|
Is Private
|
isPrivate | True | boolean |
Whether the feedback should be private |
|
Is Anonymous
|
isAnonymous | True | boolean |
Whether the feedback should be anonymous |
Returns
- Body
- Feedback
Sends a new feedback request
Sends a new feedback request.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Feedback Subject
|
feedbackAboutUPNorId | True | string |
Email or ID of the person receiving feedback |
|
Feedback Provider
|
feedbackRequestReceiverUPNorId | True | string |
Email or ID of the person who will provide feedback |
|
Request Note
|
feedbackNote | True | string |
Note to include with the feedback request |
|
Template Title
|
templateTitle | True | string |
Title of the feedback template to use |
|
Due Days
|
dueDateInDays | True | number |
Number of days until the feedback is due |
|
Is Private
|
isPrivate | True | boolean |
Whether the feedback should be private |
Returns
- Body
- Feedback
Update the progress of a goal
Update the progress of a goal
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Goal ID
|
goalId | True | string |
Unique identifier of the goal to update |
|
New Progress Value
|
newValue | True | string |
New progress value for the goal |
|
Update Comment
|
comment | string |
Comment about the progress update |
|
|
New Status
|
status | string |
New status for the goal |
|
|
Updater Type
|
goalUpdater | True | string |
Who is updating the goal (Owner or System) |
|
System Name
|
goalUpdaterSystemName | True | string |
Name of the system updating the goal |
Returns
- Body
- Goal
Updates a user with selected attributes
Updates the attributes of a user
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User Email
|
userMail | string |
The email address of the user to update. |
|
|
Attribute Label
|
label | string |
The name of the attribute to update. |
|
|
Attribute Value
|
value | string |
The value of the attribute to update. |
Definitions
Feedback
| Name | Path | Type | Description |
|---|---|---|---|
|
Feedback ID
|
id | string |
Unique identifier of the feedback |
|
Creation Date
|
createdAt | string |
Date and time when the feedback was created |
|
oid
|
createdBy.oid | string | |
|
displayName
|
createdBy.displayName | string | |
|
userPrincipalName
|
createdBy.userPrincipalName | string | |
|
oid
|
feedbackAboutUser.oid | string | |
|
displayName
|
feedbackAboutUser.displayName | string | |
|
userPrincipalName
|
feedbackAboutUser.userPrincipalName | string | |
|
oid
|
feedbackRequestRecipient.oid | string | |
|
displayName
|
feedbackRequestRecipient.displayName | string | |
|
userPrincipalName
|
feedbackRequestRecipient.userPrincipalName | string | |
|
note
|
note | string | |
|
isPrivate
|
isPrivate | boolean |
Goal
| Name | Path | Type | Description |
|---|---|---|---|
|
oid
|
createdBy.oid | string | |
|
displayName
|
createdBy.displayName | string | |
|
userPrincipalName
|
createdBy.userPrincipalName | string | |
|
startDate
|
startDate | string | |
|
dueDate
|
dueDate | string | |
|
owners
|
owners | array of object | |
|
mail
|
owners.mail | string | |
|
displayName
|
owners.displayName | string | |
|
userPrincipalName
|
owners.userPrincipalName | string | |
|
department
|
owners.department | string | |
|
jobTitle
|
owners.jobTitle | string | |
|
oid
|
owners.oid | string | |
|
title
|
title | string | |
|
goalType
|
goalType | string | |
|
isPrivate
|
isPrivate | boolean | |
|
createdAt
|
createdAt | string | |
|
relatedGroups
|
relatedGroups | array of object | |
|
items
|
relatedGroups | object | |
|
labels
|
labels | array of object | |
|
title
|
labels.title | string | |
|
description
|
labels.description | string | |
|
id
|
id | string | |
|
description
|
description | string | |
|
id
|
parentGoal.id | string | |
|
title
|
parentGoal.title | string | |
|
formatType
|
progress.formatType | string | |
|
initialValue
|
progress.initialValue | number | |
|
targetValue
|
progress.targetValue | number | |
|
currentValue
|
progress.currentValue | number | |
|
status
|
status | string | |
|
outcome
|
outcome | string |
Goals
| Name | Path | Type | Description |
|---|---|---|---|
|
Items
|
Goal |
RecognitionCreateResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
successfullyTransactions
|
successfullyTransactions | array of object | |
|
transactionId
|
successfullyTransactions.transactionId | string | |
|
recipients
|
successfullyTransactions.recipients | array of object | |
|
mail
|
successfullyTransactions.recipients.mail | string | |
|
displayName
|
successfullyTransactions.recipients.displayName | string | |
|
userPrincipalName
|
successfullyTransactions.recipients.userPrincipalName | string | |
|
oid
|
successfullyTransactions.recipients.oid | string | |
|
description
|
successfullyTransactions.badge.description | string | |
|
title
|
successfullyTransactions.badge.title | string | |
|
imageUrl
|
successfullyTransactions.badge.imageUrl | string | |
|
bgImage
|
successfullyTransactions.badge.bgImage | string | |
|
rank
|
successfullyTransactions.badge.rank | number | |
|
description
|
successfullyTransactions.description | string | |
|
comments
|
successfullyTransactions.comments | array of object | |
|
items
|
successfullyTransactions.comments | object | |
|
likes
|
successfullyTransactions.likes | array of object | |
|
items
|
successfullyTransactions.likes | object | |
|
failedTransactions
|
failedTransactions | array of string |
RecognitionResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
recipients
|
recipients | array of object | |
|
mail
|
recipients.mail | string | |
|
displayName
|
recipients.displayName | string | |
|
userPrincipalName
|
recipients.userPrincipalName | string | |
|
description
|
badge.description | string | |
|
title
|
badge.title | string | |
|
imageUrl
|
badge.imageUrl | string | |
|
bgImage
|
badge.bgImage | string | |
|
oid
|
badge.updatedBy.oid | string | |
|
displayName
|
badge.updatedBy.displayName | string | |
|
userPrincipalName
|
badge.updatedBy.userPrincipalName | string | |
|
mail
|
badge.updatedBy.mail | string | |
|
description
|
description | string | |
|
comments
|
comments | array of object | |
|
businessPhones
|
comments.user.businessPhones | array of string | |
|
displayName
|
comments.user.displayName | string | |
|
givenName
|
comments.user.givenName | string | |
|
jobTitle
|
comments.user.jobTitle | string | |
|
mail
|
comments.user.mail | string | |
|
officeLocation
|
comments.user.officeLocation | string | |
|
preferredLanguage
|
comments.user.preferredLanguage | string | |
|
surname
|
comments.user.surname | string | |
|
userPrincipalName
|
comments.user.userPrincipalName | string | |
|
id
|
comments.user.id | string | |
|
comment
|
comments.comment | string | |
|
likes
|
likes | array of object | |
|
items
|
likes | object |
RecognitionResponses
| Name | Path | Type | Description |
|---|---|---|---|
|
Items
|
RecognitionResponse |
Task
| Name | Path | Type | Description |
|---|---|---|---|
|
title
|
title | string | |
|
description
|
description | string | |
|
assignedTo
|
assignedTo | array of object | |
|
userPrincipalName
|
assignedTo.user.userPrincipalName | string | |
|
displayName
|
assignedTo.user.displayName | string | |
|
individualComments
|
assignedTo.individualComments | array of object | |
|
items
|
assignedTo.individualComments | object | |
|
attachments
|
attachments | array of object | |
|
items
|
attachments | object | |
|
labels
|
labels | array of string | |
|
descriptionAttachments
|
descriptionAttachments | array of object | |
|
items
|
descriptionAttachments | object |
Tasks
| Name | Path | Type | Description |
|---|---|---|---|
|
Items
|
Task |
User
| Name | Path | Type | Description |
|---|---|---|---|
|
userPrincipalName
|
userPrincipalName | string | |
|
createdAt
|
createdAt | string | |
|
lastLoginDate
|
lastLoginDate | string | |
|
department
|
department | string | |
|
employeeHireDate
|
employeeHireDate | string | |
|
role
|
role | string | |
|
country
|
country | string | |
|
hasManager
|
hasManager | boolean | |
|
isManager
|
isManager | boolean | |
|
jobTitle
|
jobTitle | string | |
|
officeLocation
|
officeLocation | string | |
|
preferredLanguage
|
preferredLanguage | string | |
|
name
|
name | string | |
|
attachments
|
attachments | array of object | |
|
items
|
attachments | object |