Skip to main content
GET
/
team
Get Team
curl --request GET \
  --url https://api.lemlist.com/api/team \
  --header 'Authorization: Basic <encoded-value>'
{
  "_id": "tea_b4rMsi2trBhahaha",
  "name": "lemlist",
  "userIds": [
    "usr_4YGm9ez7gMdyhahaha",
    "usr_5GdFEgSLCN4hahaha",
    "usr_F7iPChEQ3phahaha"
  ],
  "createdBy": "usr_4YGm9ez7gMdyhahaha",
  "createdAt": "2018-02-22T08:52:30.926Z",
  "hooks": [
    {
      "_id": "hoo_7bNbHKmFcpDiNACg6",
      "targetUrl": "https://hooks.zapier.com/hooks/standard/946357/*some-id*/",
      "createdAt": "2018-06-05T09:07:07.761Z",
      "zapId": 123456789,
      "type": "emailsReplied",
      "campaignId": "cam_TgyErJghahaha",
      "isFirst": true
    },
    {
      "_id": "hoo_agftPLA7RovPXuvet",
      "targetUrl": "https://hooks.zapier.com/hooks/standard/5078320/*some-other-id*/",
      "createdAt": "2019-06-05T14:38:56.535Z",
      "zapId": 987654321,
      "type": "emailsReplied",
      "campaignId": "cam_J2M3P9Z8whahaha"
    },
    {
      "_id": "hoo_PN8TP9Ny9qEJRytrm",
      "targetUrl": "https://hooks.zapier.com/hooks/standard/5078320/*some-id*/",
      "createdAt": "2019-06-05T15:49:36.624Z",
      "zapId": 59831776,
      "type": "emailsReplied",
      "campaignId": "cam_fdyDRgEwMiCJnj5Sx",
      "isFirst": true
    },
    {
      "_id": "hoo_GXALX6diEW5bovH7e",
      "targetUrl": "https://subdomain.pipedream.net",
      "createdAt": "2022-02-10T16:45:28.216Z",
      "campaignId": "cam_i6Cy2zKTw5LZpu6K5"
    }
  ],
  "slackWebhook": {
    "url": "https://hooks.slack.com/services/T123456789/B123456789/*some-id*",
    "failCounter": 1
  },
  "beta": [
    "outreachQueue",
    "crmSyncApiSalesforce",
    "voipWhitelist",
    "lemrich_postLemrichKafka",
    "computedFieldActiveCampaigns"
  ],
  "pictureId": "fil_3mwPqkGHvKbETiwmC.png",
  "invitedUsers": [
    {
      "email": "support@lemlist.com",
      "role": "member",
      "invitedBy": "usr_w7XoMXW37hahaha",
      "invitedAt": "2023-03-04T20:06:29.585Z"
    },
    {
      "email": "jojo@lemlist.co",
      "role": "admin",
      "invitedBy": "usr_tB8T7zgZEfxhahha",
      "invitedAt": "2024-09-13T12:39:55.984Z"
    }
  ],
  "agency": "usr_4YGm9ez7gMd2123456",
  "customDomain": "custom.domain.com"
}
This endpoint uses the team object.
This endpoint retrieves information about your team.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Response

Success

The organization account that manages users and billing.

_id
string

Unique team identifier

name
string

Team name

userIds
string[]

User IDs in this team

createdBy
string

User ID who created the team

createdAt
string<date-time>

Date and time when the team was created

hooks
object[]

Webhooks configured for the team

beta
string[]

Beta features enabled for the team

slackWebhook
object

Slack webhooks configured for the team

invitedUsers
object[]

Pending user invitations

agency
string

Agency identifier if team is part of an agency

pictureId
string

Team profile picture file ID

customDomain
string

Custom domain for the team