Team

These endpoints facilitate the retrieval of teams on this account.

List teams

List all the teams on this Capsule account.

GET
https://api.capsulecrm.com/api/v2/teams

Query Parameters

Name Type Description
embed Array of String

Can be used to request additional data that aren’t included in the response by default. If provided, should be a comma separated list of strings. Supported values for this endpoint are memberships (team members). Read more about embed.

Response

Returns HTTP status code 200. The body of the response will contain an object with a single property teams which is an array of Team objects.

In the case of an invalid request, an error message will be returned, as described in the errors section.

HTTP/1.1 200
{
  "teams" : [ {
    "id" : 3,
    "name" : "The North",
    "createdAt" : "2018-02-23T11:46:50Z",
    "updatedAt" : "2018-02-26T12:48:22Z"
  }, {
    "id" : 4,
    "name" : "The South",
    "createdAt" : "2018-02-23T11:46:56Z",
    "updatedAt" : "2018-02-26T12:48:31Z"
  }, {
    "id" : 5,
    "name" : "Executives",
    "createdAt" : "2018-03-01T10:38:55Z",
    "updatedAt" : "2018-03-01T10:39:01Z"
  } ]
}

Show team

Show a specific team.

GET
https://api.capsulecrm.com/api/v2/teams/{teamId}

Query Parameters

Name Type Description
embed Array of String

Can be used to request additional data that aren’t included in the response by default. If provided, should be a comma separated list of strings. Supported values for this endpoint are memberships (team members). Read more about embed.

Response

Returns HTTP status code 200. The body of the response will contain an object with a single property team which is a Team object.

HTTP/1.1 200
{
  "team" : {
    "id" : 3,
    "name" : "The North",
    "createdAt" : "2018-02-23T11:46:50Z",
    "updatedAt" : "2018-02-26T12:48:22Z"
  }
}