Share via


Powell Teams (Preview)

Powell Teams API endpoints allows you to manage the governance of your teams (creation / update of your 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 Powell Teams Support
URL https://support.powell-software.com/
Email support-teams@powellsoftware.zendesk.com
Connector Metadata
Publisher Powell Software
Website https://powell-software.com/
Privacy policy https://powell-software.com/en/powell-teams-privacy/
Categories Productivity;Collaboration

Imagine that Microsoft Teams are automatically created for projects and processes in your departments, saving time and improving collaboration. This is now possible with the powell teams API connector.

This connector contains all Powell Teams APIs and can be coupled with MS products such as flow, power app or logic app

For example, the connector can automatically trigger a team creation upon receipt of an email or through an action triggered in a third-party solution such as a CRM. This automated process means that the right team will be created to make collaboration easier.

The connector allows an infinity of solution for your business use cases

Example: RFP scenario, you will see how Linda, a sales manager, will be able to collaborate instantly with her team in a dedicated model automatically triggered following the creation of her opportunity in the CRM or the receipt of a simple e-mail.

Prerequisites

Have Powell Teams version (license with API).

How to get credentials

We use Microsoft Entra ID Graph authentication.

Getting started with your connector

https://support.powell-software.com/hc/en-us/articles/360020025800

FAQ

  • Is it possible to create teams with the connector? Yes! It’s the main application of this API connector. Create teams based on your templates

  • Is it possible to create templates with the connector? No. The template creation should be done directly on Powell Teams application

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.

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Approve or deny a pending approval

Approve or deny a pending approval

Batch methods

Batch methods

Create a team based on a Powell Teams template information

Create a team based on a Powell Teams template information

Get a naming convention by id

Get a naming convention by id

Get Job task status

Get Job task status

Get tags information from tag ids

Get tags information from tag ids

Get teams with external users report

Get teams with external users report

Get teams with missing users' report

Get teams with missing users' report

Get teams without minimum owners report

Get teams without minimum owners report

Get teams without valid naming rule report

Get teams without valid naming rule report

Get template picture

Get template picture

List all approvals

List all approvals

List all Naming conventions

List all Naming conventions

List all of user's templates

List all of user's templates

List all pending approvals of the current user

List all pending approvals of the current user

List all tags

List all tags

List all tags of a team

List all tags of a team

List all user's teams

List all user's teams

Update a team based on a Powell Teams template information

Update a team based on a Powell Teams template information

Approve or deny a pending approval

Approve or deny a pending approval

Parameters

Name Key Required Type Description
ApprovalId
ApprovalId uuid
Status
Status integer
Comment
Comment string
Created
Created date-time

Returns

Batch methods

Batch methods

Parameters

Name Key Required Type Description
Id
Id string
url
url string
method
method string
body
body object
headers
headers array of string

Returns

Create a team based on a Powell Teams template information

Create a team based on a Powell Teams template information

Parameters

Name Key Required Type Description
Description
Description string
Name
Name string
TeamTemplateId
TeamTemplateId uuid
Visibility
Visibility string
AdditionalMembers
AdditionalMembers array of string
AdditionalGroupOwners
AdditionalGroupOwners array of string
AdditionalGroupMembers
AdditionalGroupMembers array of string
AdditionalOwners
AdditionalOwners array of string
Value
Value string
TagId
TagId uuid

Returns

Get a naming convention by id

Get a naming convention by id

Parameters

Name Key Required Type Description
Naming convention id
namingId True uuid

Naming convention id

Returns

Get Job task status

Get Job task status

Parameters

Name Key Required Type Description
Task Id to check
taskId True uuid

Task Id to check

Returns

Get tags information from tag ids

Get tags information from tag ids

Parameters

Name Key Required Type Description
body
body True array of uuid

Returns

Get teams with external users report

Get teams with external users report

Returns

Get teams with missing users' report

Get teams with missing users' report

Returns

Get teams without minimum owners report

Get teams without minimum owners report

Parameters

Name Key Required Type Description
Minimum number of owners
numberOfMinimumOwners True string

Minimum number of owners

Returns

Get teams without valid naming rule report

Get template picture

Get template picture

Parameters

Name Key Required Type Description
Template Id
templateId True uuid

Template Id

Returns

response
string

List all approvals

List all Naming conventions

List all of user's templates

List all pending approvals of the current user

List all tags

List all tags of a team

List all tags of a team

Parameters

Name Key Required Type Description
Team Id
teamId True uuid

Team Id

Returns

List all user's teams

List all user's teams

Parameters

Name Key Required Type Description
Next page indicator
page uuid

Next page indicator

Returns

Update a team based on a Powell Teams template information

Update a team based on a Powell Teams template information

Parameters

Name Key Required Type Description
Team Id
teamId True uuid

Team Id of the team to update.

Description
Description string
Name
Name string
TeamTemplateId
TeamTemplateId uuid
Visibility
Visibility string
AdditionalMembers
AdditionalMembers array of string
AdditionalGroupOwners
AdditionalGroupOwners array of string
AdditionalGroupMembers
AdditionalGroupMembers array of string
AdditionalOwners
AdditionalOwners array of string
Value
Value string
TagId
TagId uuid

Returns

Definitions

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.Approval.ApiApprovalModel__

Name Path Type Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
ErrorMessage
ErrorMessage string
IsSucceed
IsSucceed boolean
Result
Result array of Powell.Teams.API.Models.Approval.ApiApprovalModel

Powell.Teams.API.Models.Approval.ApiApprovalModel

Name Path Type Description
Id
Id uuid
Histories
Histories array of Powell.Teams.API.Models.Approval.ApiApprovalHistoryModel
Team
Team Powell.Teams.API.Models.Team.ApiTeamExtendModel
TenantId
TenantId uuid
Created
Created date-time
Approvers
Approvers array of string

Powell.Teams.API.Models.Approval.ApiApprovalHistoryModel

Name Path Type Description
Id
Id uuid
Status
Status integer
Comment
Comment string
Creator
Creator Powell.Teams.API.Models.User.ApiUserModel
Created
Created date-time

Powell.Teams.API.Models.User.ApiUserModel

Name Path Type Description
Id
Id uuid
Name
Name string
AzureADId
AzureADId uuid
Email
Email string
Role
Role integer
Language
Language string
TenantId
TenantId uuid

Powell.Teams.API.Models.Team.ApiTeamExtendModel

Name Path Type Description
Id
Id uuid
OfficeGroupId
OfficeGroupId uuid
TenantId
TenantId uuid
DisplayName
DisplayName string
Description
Description string
OriginalTitle
OriginalTitle string
OriginalIncrementOfNamingRule
OriginalIncrementOfNamingRule integer
TeamTemplateId
TeamTemplateId uuid
Photo
Photo string
TagSettings
TagSettings array of Powell.Teams.API.Models.Tag.ApiTagSettingModel
Visibility
Visibility string
AdditionalMembers
AdditionalMembers array of string
AdditionalGroupOwners
AdditionalGroupOwners array of string
AdditionalGroupMembers
AdditionalGroupMembers array of string
AdditionalOwners
AdditionalOwners array of string
IsArchived
IsArchived boolean
Classification
Classification string
CurrentUserIsOwner
CurrentUserIsOwner boolean
Created
Created date-time
ExpirationStart
ExpirationStart date-time
ExpirationDate
ExpirationDate date-time
IsFavorite
IsFavorite boolean
WebUrl
WebUrl string

Powell.Teams.API.Models.Tag.ApiTagSettingModel

Name Path Type Description
Id
Id uuid
DefaultValue
DefaultValue string
ChoiceValue
ChoiceValue string
Type
Type string
TagId
TagId uuid
IsMandatory
IsMandatory boolean
IsShownToUsers
IsShownToUsers boolean
ChoiceText
ChoiceText string
Name
Name string
Value
Value string
IsMultiValueChoice
IsMultiValueChoice boolean

Powell.Teams.Common.Core.OperationResult_Powell.Teams.API.Models.Approval.ApiApprovalResult_

Name Path Type Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
ErrorMessage
ErrorMessage string
IsSucceed
IsSucceed boolean
Result
Result Powell.Teams.API.Models.Approval.ApiApprovalResult

Powell.Teams.API.Models.Approval.ApiApprovalResult

Name Path Type Description
JobTaskId
JobTaskId uuid
ApprovalId
ApprovalId uuid
Status
Status string

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.IEnumerable_Powell.Teams.API.Models.Batch.APIBatchResponseModel__

Name Path Type Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
ErrorMessage
ErrorMessage string
IsSucceed
IsSucceed boolean
Result
Result array of Powell.Teams.API.Models.Batch.APIBatchResponseModel

Powell.Teams.API.Models.Batch.APIBatchResponseModel

Name Path Type Description
Id
Id string
status
status integer
body
body Powell.Teams.API.Models.Batch.APIBatchResponseBodyModel
headers
headers array of string

Powell.Teams.API.Models.Batch.APIBatchResponseBodyModel

Name Path Type Description
value
value object
error
error Powell.Teams.API.Models.Batch.APIBatchResponseErrorModel

Powell.Teams.API.Models.Batch.APIBatchResponseErrorModel

Name Path Type Description
code
code string
message
message string

Powell.Teams.Common.Core.OperationResult_System.String_

Name Path Type Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
ErrorMessage
ErrorMessage string
IsSucceed
IsSucceed boolean
Result
Result string

Powell.Teams.Common.Core.OperationResult_Powell.Teams.API.Models.NamingConvention.ApiNamingConventionModel_

Name Path Type Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
ErrorMessage
ErrorMessage string
IsSucceed
IsSucceed boolean
Result
Result Powell.Teams.API.Models.NamingConvention.ApiNamingConventionModel

Powell.Teams.API.Models.NamingConvention.ApiNamingConventionModel

Name Path Type Description
Id
Id uuid
Configuration
Configuration array of Powell.Teams.API.Models.NamingConvention.ApiNamingConventionConfigurationModel
IsMetaNamingRule
IsMetaNamingRule boolean
Name
Name string
NumberIncrement
NumberIncrement integer

Powell.Teams.API.Models.NamingConvention.ApiNamingConventionConfigurationModel

Name Path Type Description
Type
Type string
Value
Value string

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.NamingConvention.ApiNamingConventionModel__

Name Path Type Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
ErrorMessage
ErrorMessage string
IsSucceed
IsSucceed boolean
Result
Result array of Powell.Teams.API.Models.NamingConvention.ApiNamingConventionModel

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.Report.ApiTeamReport__

Name Path Type Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
ErrorMessage
ErrorMessage string
IsSucceed
IsSucceed boolean
Result
Result array of Powell.Teams.API.Models.Report.ApiTeamReport

Powell.Teams.API.Models.Report.ApiTeamReport

Name Path Type Description
GroupId
GroupId uuid
CreationDate
CreationDate date-time
LastUpdateDate
LastUpdateDate date-time
Title
Title string
Description
Description string
Photo
Photo string
IsArchived
IsArchived boolean
IsInactive
IsInactive boolean
Link
Link string
PowellTemplateId
PowellTemplateId uuid
PowellTemplateName
PowellTemplateName string
OwnersIds
OwnersIds array of string
NbOwners
NbOwners integer
MembersIds
MembersIds array of string
NbMembers
NbMembers integer
ExternalUsersIds
ExternalUsersIds array of string
NbExternals
NbExternals integer
LastChatActivity
LastChatActivity date-time
NbChatMessages
NbChatMessages integer
NbChatReplies
NbChatReplies integer
ChatMessageDeltaParameters
ChatMessageDeltaParameters array of Powell.Teams.Model.Unmapped.ChatMessageDeltaParameters
LastDocActivity
LastDocActivity date-time
NbDocuments
NbDocuments integer
DriveItemDeltaParameters
DriveItemDeltaParameters Powell.Teams.Model.Unmapped.DriveItemDeltaParameters
MinimumNumberOfOwners
MinimumNumberOfOwners integer
MinimumNumberOfMembers
MinimumNumberOfMembers integer
Visibility
Visibility string
ExpirationDate
ExpirationDate date-time
ExpirationStart
ExpirationStart date-time

Powell.Teams.Model.Unmapped.ChatMessageDeltaParameters

Name Path Type Description
TeamId
TeamId string
ChannelId
ChannelId string
DeltaLink
DeltaLink string

Powell.Teams.Model.Unmapped.DriveItemDeltaParameters

Name Path Type Description
GroupId
GroupId string
DeltaLink
DeltaLink string

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.IEnumerable_Powell.Teams.API.Models.Tag.ApiTagSimpleModel__

Name Path Type Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
ErrorMessage
ErrorMessage string
IsSucceed
IsSucceed boolean
Result
Result array of Powell.Teams.API.Models.Tag.ApiTagSimpleModel

Powell.Teams.API.Models.Tag.ApiTagSimpleModel

Name Path Type Description
Id
Id uuid
Name
Name string
Type
Type string
IsMultiValueChoice
IsMultiValueChoice boolean
Choices
Choices array of Powell.Teams.API.Models.Tag.ApiTagChoiceModel

Powell.Teams.API.Models.Tag.ApiTagChoiceModel

Name Path Type Description
Id
Id uuid
Value
Value string

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.Tag.ApiTagModel__

Name Path Type Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
ErrorMessage
ErrorMessage string
IsSucceed
IsSucceed boolean
Result
Result array of Powell.Teams.API.Models.Tag.ApiTagModel

Powell.Teams.API.Models.Tag.ApiTagModel

Name Path Type Description
ChoicesJson
ChoicesJson string
Id
Id uuid
IsRefiner
IsRefiner boolean
Name
Name string
Type
Type string

Powell.Teams.Common.Core.OperationResult_System.Guid_

Name Path Type Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
ErrorMessage
ErrorMessage string
IsSucceed
IsSucceed boolean
Result
Result uuid

Powell.Teams.Common.Core.OperationResult_Powell.Teams.API.Models.PublicAPIResponses.PaginatedAPIResponseModel_Powell.Teams.API.Models.Team.ApiTeamModel__

Name Path Type Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
ErrorMessage
ErrorMessage string
IsSucceed
IsSucceed boolean
Result
Result Powell.Teams.API.Models.PublicAPIResponses.PaginatedAPIResponseModel_Powell.Teams.API.Models.Team.ApiTeamModel_

Powell.Teams.API.Models.PublicAPIResponses.PaginatedAPIResponseModel_Powell.Teams.API.Models.Team.ApiTeamModel_

Name Path Type Description
Items
Items array of Powell.Teams.API.Models.Team.ApiTeamModel
NextPage
NextPage string

Powell.Teams.API.Models.Team.ApiTeamModel

Name Path Type Description
Id
Id uuid
OfficeGroupId
OfficeGroupId uuid
TenantId
TenantId uuid
DisplayName
DisplayName string
Description
Description string
OriginalTitle
OriginalTitle string
OriginalIncrementOfNamingRule
OriginalIncrementOfNamingRule integer
TeamTemplateId
TeamTemplateId uuid
TagSettings
TagSettings array of Powell.Teams.API.Models.Tag.ApiTagSettingModel
Visibility
Visibility string
AdditionalMembers
AdditionalMembers array of string
AdditionalGroupOwners
AdditionalGroupOwners array of string
AdditionalGroupMembers
AdditionalGroupMembers array of string
AdditionalOwners
AdditionalOwners array of string
IsArchived
IsArchived boolean
Classification
Classification string
CurrentUserIsOwner
CurrentUserIsOwner boolean
Created
Created date-time
ExpirationStart
ExpirationStart date-time
ExpirationDate
ExpirationDate date-time
IsFavorite
IsFavorite boolean
WebUrl
WebUrl string

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.Tag.ApiTagSettingModel__

Name Path Type Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
ErrorMessage
ErrorMessage string
IsSucceed
IsSucceed boolean
Result
Result array of Powell.Teams.API.Models.Tag.ApiTagSettingModel

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.TeamTemplate.ApiTeamTemplateSimpleModel__

Name Path Type Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
ErrorMessage
ErrorMessage string
IsSucceed
IsSucceed boolean
Result
Result array of Powell.Teams.API.Models.TeamTemplate.ApiTeamTemplateSimpleModel

Powell.Teams.API.Models.TeamTemplate.ApiTeamTemplateSimpleModel

Name Path Type Description
Id
Id uuid
AdditionalMembers
AdditionalMembers array of string
AdditionalOwners
AdditionalOwners array of string
Approvers
Approvers array of string
Categories
Categories array of uuid
Description
Description string
DisplayName
DisplayName string
IsPublished
IsPublished boolean
LastSchemaSynchronisation
LastSchemaSynchronisation string
MinimumMembers
MinimumMembers integer
MinimumOwners
MinimumOwners integer
NamingConventionId
NamingConventionId uuid
TagSettings
TagSettings array of Powell.Teams.API.Models.Tag.ApiTagSettingModel
TeamIdToClone
TeamIdToClone uuid
TeamsCount
TeamsCount integer
Visibility
Visibility string

string

This is the basic data type 'string'.