Team Resource

Teams are groups of developers on Discord who want to collaborate on apps. On other platforms, these may be referred to as "organizations", "companies", or "teams". Discord went with the name Teams because it best encompassed all the awesome conglomerates of devs that work together to make awesome things on Discord. Also, none of you ever got picked for kickball in gym class, so now you get to be on a team.

Teams allow you and other Discord users to share access to apps. No more sharing login credentials in order to reset the token on a bot that your friend owns but you work on, or other such cases.

For game developers, this means that you can get your engineers access to your app for credentials they may need, your marketing folks access to store page management, and your finance people access to sales and performance metrics.

¹ The default team icon uses the same images as default avatars and can be calculated using team_id % 5.

² Only provided in the application object.

³ Only included when fetched from Get Team or Get Teams with include_payout_account_status set to true.

⁴ Only included when fetched from Get Team.

{
  "id": "1110738998453837384",
  "icon": null,
  "name": "Power",
  "owner_user_id": "852892297661906993",
  "payout_account_status": 1
}

Team members can be one of four roles (owner, admin, developer, and read-only), and each role inherits the access of those below it. Roles for team members can be configured under Team Members in a team's settings.

{
  "user": {
    "id": "852892297661906993",
    "username": "alien",
    "global_name": "Alien",
    "avatar": "05145cc5646fbcba277b6d5ea2030610",
    "discriminator": "0",
    "public_flags": 64,
    "avatar_decoration_data": null
  },
  "team_id": "1110738998453870732",
  "membership_state": 2,
  "role": "admin"
}

{
  "id": "1110738998453870732",
  "user_id": "852892297661906993",
  "amount": 1000000,
  "status": 1,
  "period_start": "2021-01-01",
  "period_end": null,
  "payout_date": null
}

A development/publishing company working on a game on Discord.

{
  "id": "1058932127820939295",
  "name": "AlienTec"
}

Returns a list of team objects that the current user is a member of.

Creates a new team. Returns a team object on success. Users can join a maximum of 30 teams.

Returns a team object for the given team ID.

Modifies a team. User must be an admin of the team. Returns the updated team object on success.

Deletes a team permanently. User must be the owner of the team. Returns a 204 empty response on success.

Accepts an invite to join a team. Returns a team object on success. Users can join a maximum of 30 teams.

¹ This token can be retrieved by visiting the emailed https://click.discord.com/ link and extracting the #token URI fragment from the redirect URL.

Returns a list of team member objects for the given team ID.

Invites a user to the team. User must be an admin of the team. Returns a team member object on success.

¹ null for migrated users. See the section on Discord's new username system for more information.

Modifies a team member. User must be an admin of the team. Returns the updated team member object on success.

Removes a team member. User must be the an admin of the team unless removing themselves. Returns a 204 empty response on success.

Returns a list of application objects for the given team ID.

Returns a link that can be used to access the team's Stripe Connect payout account dashboard.

{
  "stripe_connect_redirect_url": "https://connect.stripe.com/setup/e/acct_123456/789abcd"
}

Returns a link that can be embedded in an IFrame to allow the user to access the team's Tipalti payout account dashboard. User must be the owner of the team.

{
  "url": "https://ui2.tipalti.com/payeedashboard/home?ts=12345&idap=10418817887227111107389984538707326773&payer=Discord&hashkey=123456abcd"
}

Returns a list of team payout objects for the given team ID.

Returns a CSV file containing the payout report for the given payout ID.

Returns a list of company objects that match the given query. If no results are found, returns a 204 empty response.

Creates a new company under this team. Returns a company object on success.