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

Operation ID:

postBetaApprovalsApprove

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

Body

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

Batch methods

Operation ID:

postBetabatch

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

Body

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

Create a team based on a Powell Teams template information

Operation ID:

postBetaTeams

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

Body

Powell.Teams.Common.Core.OperationResult_System.Guid_

Get a naming convention by id

Operation ID:

getBetaNamingconventionsByNamingId

Get a naming convention by id

Parameters

Name	Key	Required	Type	Description
Naming convention id	namingId	True	uuid	Naming convention id

Returns

Body

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

Get Job task status

Operation ID:

getBetaJobtasksGetstatusByTaskId

Get Job task status

Parameters

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

Returns

Body

Powell.Teams.Common.Core.OperationResult_System.String_

Get tags information from tag ids

Operation ID:

postBetaTagsList

Get tags information from tag ids

Parameters

Name	Key	Required	Type	Description
body	body	True	array of uuid

Returns

Body

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

Get teams with external users report

Operation ID:

getBetaReportsTeamsWithExternalUsers

Get teams with external users report

Returns

response

array of Powell.Teams.API.Models.Report.ApiTeamReport

Get teams with missing users' report

Operation ID:

getBetaReportsTeamsWithMissingUsers

Get teams with missing users' report

Returns

response

array of Powell.Teams.API.Models.Report.ApiTeamReport

Get teams without minimum owners report

Operation ID:

getBetaReportsTeamsWithoutMinimumOwnersByNumberOfMinimumOwners

Get teams without minimum owners report

Parameters

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

Returns

Body

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

Get teams without valid naming rule report

Operation ID:

getBetaReportsTeamsWithoutValidNamingRule

Get teams without valid naming rule report

Returns

Body

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

Get template picture

Operation ID:

getBetaTemplatesByTemplateIdPicture

Get template picture

Parameters

Name	Key	Required	Type	Description
Template Id	templateId	True	uuid	Template Id

Returns

response

string

List all approvals

Operation ID:

getBetaApprovals

List all approvals

Returns

Body

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

List all Naming conventions

Operation ID:

getBetaNamingconventions

List all Naming conventions

Returns

Body

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

List all of user's templates

Operation ID:

getBetaTemplates

List all of user's templates

Returns

Body

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

List all pending approvals of the current user

Operation ID:

getBetaApprovalsPending

List all pending approvals of the current user

Returns

Body

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

List all tags

Operation ID:

getBetaTags

List all tags

Returns

Body

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

List all tags of a team

Operation ID:

getBetaTeamsByTeamIdTags

List all tags of a team

Parameters

Name	Key	Required	Type	Description
Team Id	teamId	True	uuid	Team Id

Returns

Body

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

List all user's teams

Operation ID:

getBetaTeams

List all user's teams

Parameters

Name	Key	Required	Type	Description
Next page indicator	page		uuid	Next page indicator

Returns

Body

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

Update a team based on a Powell Teams template information

Operation ID:

putBetaTeamsByTeamId

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

Body

Powell.Teams.Common.Core.OperationResult_System.Guid_

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'.