Create Teams via API

[Eleanor Mallory]

My organization manages "teams" through an in-house tool, as the team structure doesn't map to our Org chart and changes frequently.

Is there a way to create Teams in Platform Experiences via an API? We'd like to not have to manage them in 2 places, and want the Goals in Platform Experiences to map to the teams we've created in our system.

[Eleanor Mallory]

I found this API documentation but I'm not sure if it's referring to Platform Experiences teams or something else?

https://developer.atlassian.com/platform/teams/rest/v1/api-group-teams-public-api/#api-gateway-api-public-teams-v1-org-orgid-teams-post

https://developer.atlassian.com/platform/teams/rest/v1/api-group-teams-members-public-api/#api-gateway-api-public-teams-v1-org-orgid-teams-teamid-members-add-post

[andy_johnston]

I believe this is the right API for Atlas/Platform Experience.  The team is at the Org level, not within the projects.  You could run some tests with Postman to see if it's able to do what you want. 

[Eleanor Mallory]

Do you know what account Id is needed to map individuals? 

[Darryl Lee]

@Eleanor Mallory It's the Atlassian accountId, which you can obtain at a site level with this API, if you have their username (email address): 

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-group-and-user-picker/#api-rest-api-3-groupuserpicker-get

[April Chi]

Hey @Eleanor Mallory 👋

I'm April, a Product Manager at Atlassian looking after Teams. Andy is correct, we call it 'Atlassian Teams' and that is our public API. 

Let me know if you have any further questions. 

Side note: Interested in your use case - how come the team structure doesn't map to the org chart? Where's your source of truth for teams?

[Eleanor Mallory]

@April Chi We use a "pods & pillars" structure to organize teams around projects with some flexibility to move people between pods based on priorities. Shared resources like UX designers, QE, architects are all on teams together, but may be assigned to different pods for doing work. Pod leaders may not be the org chart manager for all the members of a pod.