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

API reference

Campaigns & Lists

A campaign is a dialing queue. A list groups leads inside your dialer (for example, one import). Both are managed in Saleso; the API reads them so you can pick the right ID.

Get Active Campaigns

GET/api/make/campaigns/{teamId}

Gets your team's active dialer campaigns.

Used by:
Make: Get Campaigns · Zapier: Get Active Campaigns · campaign pickers

Parameters

  • teamIdstringrequired

    Your Team ID.

Response

2 response fieldsShow
  • campaigns[].idstring

    Campaign ID

  • campaigns[].namestring

    Name

  • Only active campaigns are returned.

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/campaigns/$SALESO_TEAM_ID" \
  -H "x-api-key: $SALESO_API_KEY"
Response · 200
{
  "campaigns": [
    {
      "id": "015fc401-4a09-4352-b538-0964b7fec075",
      "name": "Website leads"
    }
  ]
}

List Lead Lists

GET/api/make/lists/{teamId}

Lists your active dialer lists, for the list_id parameter of Create Lead and Add Leads to Campaign.

Used by:
Make and Zapier: list pickers

Parameters

  • teamIdstringrequired

    Your Team ID.

Response

2 response fieldsShow
  • lists[].idstring

    The list ID to send as list_id. This is the dialer’s own list ID, not a UUID.

  • lists[].namestring

    Display name (falls back to the ID when the list has no 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/lists/$SALESO_TEAM_ID" \
  -H "x-api-key: $SALESO_API_KEY"
Response · 200
{
  "lists": [
    {
      "id": "list-2041",
      "name": "October import"
    }
  ]
}