POST/api/v1/workspaces/{workspace_id}/teams

Create a team

Workspace admins only. visibility is open (anyone in the workspace can browse and search it) or private (its members only; workspace admins can still see it). lead_ids and member_ids are workspace members.

API token required60 per minute per IPMCP: create_team
Code samples and Try it

Path parameters

#
  • workspace_idstringRequired

    The workspace's id, from the address of its settings page (markdrop.in/settings/workspaces/<workspace-id>) or from List workspaces.

Request body

#

application/json, required

  • namestringRequired

    1–80 characters.

  • iconstring

    Up to 16 characters.

  • color"blue" | "green" | "amber" | "red" | "violet" | "pink" | "teal" | "gray"
  • descriptionstring

    Up to 400 characters.

  • visibility"open" | "private"

    Default "open".

  • lead_idsarray of string

    Up to 50 items.

  • member_idsarray of string

    Up to 1,000 items.

Responses

#
  • 201Created.
  • 401No token, or the token is revoked or mistyped.
  • 422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
  • 429Too many requests from your IP address. Wait the seconds in Retry-After.
Did this page help?