KosmoKrator

sales

Salesloft Lua API for KosmoKrator Agents

Agent-facing Lua documentation and function reference for the Salesloft KosmoKrator integration.

6 functions 5 read 1 write Bearer token auth

Lua Namespace

Agents call this integration through app.integrations.salesloft.*. Use lua_read_doc("integrations.salesloft") inside KosmoKrator to discover the same reference at runtime.

Agent-Facing Lua Docs

This is the rendered version of the full Lua documentation exposed to agents when they inspect the integration namespace.

Salesloft — Lua API Reference

list_sequences

List call sequences from Salesloft with optional status filtering and pagination.

Parameters

NameTypeRequiredDescription
limitintegernoMaximum number of sequences to return per page (default: 25)
pageintegernoPage number for pagination (default: 1)
statusstringnoFilter by sequence status (e.g., "active", "paused")

Examples

List all active sequences

local result = app.integrations.salesloft.list_sequences({
  status = "active",
  limit = 50
})

for _, seq in ipairs(result.data) do
  print(seq.id .. ": " .. seq.name .. " (" .. seq.status .. ")")
end

Paginate through sequences

local result = app.integrations.salesloft.list_sequences({
  limit = 25,
  page = 2
})

get_sequence

Get detailed information about a specific call sequence.

Parameters

NameTypeRequiredDescription
idintegeryesThe sequence ID

Examples

Get a sequence by ID

local result = app.integrations.salesloft.get_sequence({
  id = 12345
})

print("Name: " .. result.data.name)
print("Status: " .. result.data.status)
print("Owner: " .. result.data.owner_id)

create_sequence

Create a new call sequence in Salesloft.

Parameters

NameTypeRequiredDescription
namestringyesName of the call sequence
stepsarraynoArray of step definitions for the sequence
owner_idintegernoID of the user who will own this sequence
statusstringnoInitial status (e.g., "active", "paused")
targetsarraynoArray of target people or account IDs

Examples

Create a simple sequence

local result = app.integrations.salesloft.create_sequence({
  name = "Q1 Outreach Campaign",
  owner_id = 42,
  status = "active"
})

print("Created sequence: " .. result.data.id)

Create a sequence with steps and targets

local result = app.integrations.salesloft.create_sequence({
  name = "Follow-up Campaign",
  owner_id = 42,
  steps = {
    { type = "call", name = "Initial Call" },
    { type = "email", name = "Follow-up Email" }
  },
  targets = { 101, 102, 103 },
  status = "active"
})

list_rules

List automation rules from Salesloft with pagination.

Parameters

NameTypeRequiredDescription
limitintegernoMaximum number of rules to return per page (default: 25)
pageintegernoPage number for pagination (default: 1)

Examples

List all rules

local result = app.integrations.salesloft.list_rules({
  limit = 50
})

for _, rule in ipairs(result.data) do
  print(rule.id .. ": " .. rule.name)
end

get_rule

Get detailed information about a specific automation rule.

Parameters

NameTypeRequiredDescription
idintegeryesThe rule ID

Examples

Get a rule by ID

local result = app.integrations.salesloft.get_rule({
  id = 67890
})

print("Rule: " .. result.data.name)

get_current_user

Get the profile of the currently authenticated Salesloft user. Useful for verifying credentials and identifying the connected account.

Parameters

None.

Examples

Get current user

local result = app.integrations.salesloft.get_current_user({})

print("User: " .. result.data.first_name .. " " .. result.data.last_name)
print("Email: " .. result.data.email)

Multi-Account Usage

If you have multiple Salesloft accounts configured, use account-specific namespaces:

-- Default account (always works)
app.integrations.salesloft.list_sequences({...})

-- Explicit default (portable across setups)
app.integrations.salesloft.default.list_sequences({...})

-- Named accounts
app.integrations.salesloft.production.list_sequences({...})
app.integrations.salesloft.staging.list_sequences({...})

All functions are identical across accounts — only the credentials differ.

Raw agent markdown
# Salesloft — Lua API Reference

## list_sequences

List call sequences from Salesloft with optional status filtering and pagination.

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `limit` | integer | no | Maximum number of sequences to return per page (default: 25) |
| `page` | integer | no | Page number for pagination (default: 1) |
| `status` | string | no | Filter by sequence status (e.g., `"active"`, `"paused"`) |

### Examples

#### List all active sequences

```lua
local result = app.integrations.salesloft.list_sequences({
  status = "active",
  limit = 50
})

for _, seq in ipairs(result.data) do
  print(seq.id .. ": " .. seq.name .. " (" .. seq.status .. ")")
end
```

#### Paginate through sequences

```lua
local result = app.integrations.salesloft.list_sequences({
  limit = 25,
  page = 2
})
```

---

## get_sequence

Get detailed information about a specific call sequence.

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `id` | integer | yes | The sequence ID |

### Examples

#### Get a sequence by ID

```lua
local result = app.integrations.salesloft.get_sequence({
  id = 12345
})

print("Name: " .. result.data.name)
print("Status: " .. result.data.status)
print("Owner: " .. result.data.owner_id)
```

---

## create_sequence

Create a new call sequence in Salesloft.

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `name` | string | yes | Name of the call sequence |
| `steps` | array | no | Array of step definitions for the sequence |
| `owner_id` | integer | no | ID of the user who will own this sequence |
| `status` | string | no | Initial status (e.g., `"active"`, `"paused"`) |
| `targets` | array | no | Array of target people or account IDs |

### Examples

#### Create a simple sequence

```lua
local result = app.integrations.salesloft.create_sequence({
  name = "Q1 Outreach Campaign",
  owner_id = 42,
  status = "active"
})

print("Created sequence: " .. result.data.id)
```

#### Create a sequence with steps and targets

```lua
local result = app.integrations.salesloft.create_sequence({
  name = "Follow-up Campaign",
  owner_id = 42,
  steps = {
    { type = "call", name = "Initial Call" },
    { type = "email", name = "Follow-up Email" }
  },
  targets = { 101, 102, 103 },
  status = "active"
})
```

---

## list_rules

List automation rules from Salesloft with pagination.

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `limit` | integer | no | Maximum number of rules to return per page (default: 25) |
| `page` | integer | no | Page number for pagination (default: 1) |

### Examples

#### List all rules

```lua
local result = app.integrations.salesloft.list_rules({
  limit = 50
})

for _, rule in ipairs(result.data) do
  print(rule.id .. ": " .. rule.name)
end
```

---

## get_rule

Get detailed information about a specific automation rule.

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `id` | integer | yes | The rule ID |

### Examples

#### Get a rule by ID

```lua
local result = app.integrations.salesloft.get_rule({
  id = 67890
})

print("Rule: " .. result.data.name)
```

---

## get_current_user

Get the profile of the currently authenticated Salesloft user. Useful for verifying credentials and identifying the connected account.

### Parameters

None.

### Examples

#### Get current user

```lua
local result = app.integrations.salesloft.get_current_user({})

print("User: " .. result.data.first_name .. " " .. result.data.last_name)
print("Email: " .. result.data.email)
```

---

## Multi-Account Usage

If you have multiple Salesloft accounts configured, use account-specific namespaces:

```lua
-- Default account (always works)
app.integrations.salesloft.list_sequences({...})

-- Explicit default (portable across setups)
app.integrations.salesloft.default.list_sequences({...})

-- Named accounts
app.integrations.salesloft.production.list_sequences({...})
app.integrations.salesloft.staging.list_sequences({...})
```

All functions are identical across accounts — only the credentials differ.

Metadata-Derived Lua Example

local result = app.integrations.salesloft.salesloft_list_sequences({
  limit = 1,
  page = 1,
  status = "example_status"
})
print(result)

Functions

salesloft_list_sequences

List call sequences from Salesloft. Returns sequences with their IDs, names, statuses, and metadata. Supports pagination and optional status filtering.

Operation
Read read
Full name
salesloft.salesloft_list_sequences
ParameterTypeRequiredDescription
limit integer no Maximum number of sequences to return per page (default: 25).
page integer no Page number for pagination (default: 1).
status string no Filter sequences by status (e.g., "active", "paused").

salesloft_get_sequence

Get detailed information about a specific call sequence in Salesloft by its ID.

Operation
Read read
Full name
salesloft.salesloft_get_sequence
ParameterTypeRequiredDescription
id integer yes The sequence ID.

salesloft_create_sequence

Create a new call sequence in Salesloft with steps, owner assignment, status, and targets.

Operation
Write write
Full name
salesloft.salesloft_create_sequence
ParameterTypeRequiredDescription
name string yes Name of the call sequence.
steps array no Array of step definitions for the sequence. Each step defines an action (e.g., call, email).
owner_id integer no ID of the user who will own this sequence.
status string no Initial status of the sequence (e.g., "active", "paused").
targets array no Array of target people or account IDs to add to the sequence.

salesloft_list_rules

List automation rules from Salesloft. Returns rules with their IDs, names, conditions, and actions.

Operation
Read read
Full name
salesloft.salesloft_list_rules
ParameterTypeRequiredDescription
limit integer no Maximum number of rules to return per page (default: 25).
page integer no Page number for pagination (default: 1).

salesloft_get_rule

Get detailed information about a specific automation rule in Salesloft by its ID.

Operation
Read read
Full name
salesloft.salesloft_get_rule
ParameterTypeRequiredDescription
id integer yes The rule ID.

salesloft_get_current_user

Get the profile of the currently authenticated Salesloft user. Useful for verifying credentials and identifying the connected account.

Operation
Read read
Full name
salesloft.salesloft_get_current_user
ParameterTypeRequiredDescription
No parameters.