דלג לתוכן הראשי
SalesoDevelopers
Sign in
Reference indexShow

API reference

Team & Connection

Use Test Connection to validate credentials before saving them. Team members are the reps you assign leads and calls to.

Test Connection

GETPOST/api/make/health/{teamId}

Checks that the Team ID and API key match, and returns the team’s name.

Used by:
Make: connection test · Zapier: authentication test and connection label

Parameters

  • teamIdstringrequired

    Your Team ID.

Response

2 response fieldsShow
  • successboolean

    Always true on a 200.

  • team_namestring

    Your team’s name in Saleso, or null if it has none.

  • Accepts GET or POST; neither takes a body.

Errors

  • 401Missing API key or Invalid API key.
  • 500Unexpected server error. The error field carries the message.
Request
curl -X GET "https://try.saleso.io/api/make/health/$SALESO_TEAM_ID" \
  -H "x-api-key: $SALESO_API_KEY"
Response · 200
{
  "success": true,
  "team_name": "Levi Logistics Sales"
}

Get Team Members

GET/api/make/team/{teamId}

Gets all members of your Saleso team.

Used by:
Make: Get Team Members · Zapier: Get Team Members · rep pickers

Parameters

  • teamIdstringrequired

    Your Team ID.

  • activeboolean· Query

    Send 1 or true for active human reps only (removed users and voice bots left out). By default everyone in the team is returned.

Response

7 response fieldsShow
  • members[].idstring

    User ID

  • members[].first_namestring

    First Name

  • members[].last_namestring

    Last Name

  • members[].emailstring

    Email

  • members[].rolestring

    The user’s role, e.g. SALES_TEAM_MANAGER or SALESPERSON.

  • members[].namestring

    Display name: first and last name, falling back to email.

  • members[].billing_statusstring

    Seat status: active, invited, paused or removed; may be null.

  • Sorted by first name.

Errors

  • 401The API key is missing, wrong, or belongs to another team (Invalid API key).
  • 500Unexpected server error. The error field carries the message.
Request
curl -X GET "https://try.saleso.io/api/make/team/$SALESO_TEAM_ID" \
  -H "x-api-key: $SALESO_API_KEY"
Response · 200
{
  "members": [
    {
      "id": "f554b8ba-54c4-43e4-abd9-77c75040fe59",
      "first_name": "Noa",
      "last_name": "Cohen",
      "email": "noa@example.com",
      "role": "SALESPERSON",
      "name": "Noa Cohen",
      "billing_status": "active"
    }
  ]
}