ReferenceCommands

Import Sales Navigator Filters

Import prospects using structured Sales Navigator people filters.

importsapprovalallow
Import Sales Navigator Filters

Import prospects using structured Sales Navigator people filters.

When to use

Use this when the agent or a deterministic automation is building a prospecting list from filter inputs.

Risk notes

  • This command imports and creates leads, so it is approval-gated.

Output notes

  • Responses default to `full` mode through the public API and CLI.
  • Use `compact` only when token savings matter more than prospecting quality. It can noticeably reduce prospecting quality.
  • Commands marked with `approval` risk currently execute directly. `approval_output_schema` is retained for compatibility.

Output schema

json
{
  "type": "object",
  "properties": {
    "import_id": {
      "type": "string"
    },
    "import_type": {
      "type": "string"
    },
    "import_name": {
      "type": "string"
    },
    "created_count": {
      "type": "integer"
    },
    "skipped_count": {
      "type": "integer"
    },
    "invalid_count": {
      "type": "integer"
    },
    "updated_count": {
      "type": "integer"
    },
    "updated_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "already_exists": {
      "type": "boolean"
    },
    "message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "mission": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "name"
      ],
      "additionalProperties": false
    },
    "generated_search_url": {
      "type": "string"
    },
    "generated_search_params": {
      "type": "object",
      "additionalProperties": true
    }
  },
  "required": [
    "import_id",
    "import_type",
    "import_name",
    "created_count",
    "skipped_count",
    "invalid_count",
    "updated_count",
    "updated_ids",
    "already_exists",
    "message",
    "mission",
    "generated_search_url",
    "generated_search_params"
  ],
  "additionalProperties": false
}

Approval output schema

json
{
  "type": "object",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "approval_required": {
      "const": true
    }
  },
  "required": [
    "account_id",
    "approval_required"
  ],
  "additionalProperties": false
}

CLI

bash
salestouch commands run import.sales-nav.filters --input-json '{"filters":{}}' --json

Payload

json
{
  "filters": {}
}

Runtime Command

import.sales-nav.filters is exposed through the shared SalesTouch runtime and stays available across API, CLI and MCP.

HTTP Reference

POST
/api/v1/commands/{commandId}

Authorization

AuthorizationBearer <token>

Use Authorization: Bearer <salestouch_api_key>.

In: header

Path Parameters

commandId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://www.salestouch.io/api/v1/commands/string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "ok": true,
  "status": 0,
  "data": {},
  "error": {
    "code": "string",
    "message": "string"
  },
  "meta": {
    "approval_required": true,
    "approval_request_id": "string",
    "command_hash": "string",
    "warnings": [
      "string"
    ]
  }
}
{
  "ok": true,
  "status": 0,
  "data": {},
  "error": {
    "code": "string",
    "message": "string"
  },
  "meta": {
    "approval_required": true,
    "approval_request_id": "string",
    "command_hash": "string",
    "warnings": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
{
  "ok": true,
  "status": 0,
  "data": {},
  "error": {
    "code": "string",
    "message": "string"
  },
  "meta": {
    "approval_required": true,
    "approval_request_id": "string",
    "command_hash": "string",
    "warnings": [
      "string"
    ]
  }
}
{
  "ok": true,
  "status": 0,
  "data": {},
  "error": {
    "code": "string",
    "message": "string"
  },
  "meta": {
    "approval_required": true,
    "approval_request_id": "string",
    "command_hash": "string",
    "warnings": [
      "string"
    ]
  }
}
{
  "ok": true,
  "status": 0,
  "data": {},
  "error": {
    "code": "string",
    "message": "string"
  },
  "meta": {
    "approval_required": true,
    "approval_request_id": "string",
    "command_hash": "string",
    "warnings": [
      "string"
    ]
  }
}

Schema Reference

GET
/api/v1/commands/{commandId}/schema

Authorization

AuthorizationBearer <token>

Use Authorization: Bearer <salestouch_api_key>.

In: header

Path Parameters

commandId*string

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://www.salestouch.io/api/v1/commands/string/schema"
{
  "data": {
    "command": {
      "command_id": "string",
      "title": "string",
      "description": "string",
      "summary": "string",
      "visibility": "public",
      "risk": "read",
      "category": "linkedin",
      "default_permission": "allow",
      "when_to_use": "string",
      "risk_notes": [
        "string"
      ],
      "output_notes": [
        "string"
      ],
      "related_commands": [
        "string"
      ],
      "related_resources": [
        "string"
      ],
      "examples": [
        {
          "title": "string",
          "language": "string",
          "code": "string"
        }
      ],
      "input_schema": {},
      "output_schema": {},
      "approval_output_schema": {}
    }
  }
}
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
{
  "error": {
    "message": "string",
    "code": "string"
  }
}

On this page