Can I use Zendesk Sell as a CLI?

Yes. KosmoKrator exposes a Zendesk Sell CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Zendesk Sell through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Zendesk Sell tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Zendesk Sell credentials stored?

Zendesk Sell credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Zendesk Sell MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

sales

Zendesk Sell CLI for AI Agents

Use the Zendesk Sell CLI from KosmoKrator to call Zendesk Sell tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

7 functions 6 read 1 write Bearer token auth

Submit Zendesk Sell feedback View package source

Zendesk Sell CLI Setup

Zendesk Sell can be configured headlessly with `kosmokrator integrations:configure zendesk-sell`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure zendesk-sell --set access_token="$ZENDESK_SELL_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor zendesk-sell --json
kosmokrator integrations:status --json

Credentials

Authentication type: Bearer token bearer_token. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`access_token`	`ZENDESK_SELL_ACCESS_TOKEN`	Secret `secret`	yes	Access Token
`url`	`ZENDESK_SELL_URL`	URL `url`	no	API Base URL

Call Zendesk Sell Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call zendesk-sell.zendesk_sell_list_contacts '{
  "page": 1,
  "per_page": 1,
  "sort_by": "example_sort_by"
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:zendesk-sell zendesk_sell_list_contacts '{
  "page": 1,
  "per_page": 1,
  "sort_by": "example_sort_by"
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs zendesk-sell --json
kosmo integrations:docs zendesk-sell.zendesk_sell_list_contacts --json
kosmo integrations:schema zendesk-sell.zendesk_sell_list_contacts --json
kosmo integrations:search "Zendesk Sell" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Zendesk Sell.

`zendesk-sell.zendesk_sell_list_contacts`

Read read

List contacts in Zendesk Sell. Returns paginated results sorted by the specified field. Use this to browse, search, or export contacts from the CRM.

Parameters: page, per_page, sort_by

Generic CLI call

kosmo integrations:call zendesk-sell.zendesk_sell_list_contacts '{"page":1,"per_page":1,"sort_by":"example_sort_by"}' --json

Provider shortcut

kosmo integrations:zendesk-sell zendesk_sell_list_contacts '{"page":1,"per_page":1,"sort_by":"example_sort_by"}' --json

`zendesk-sell.zendesk_sell_get_contact`

Read read

Get full details of a specific contact in Zendesk Sell by its ID. Returns all contact fields including email, phone, organization, and custom fields.

Parameters: id

Generic CLI call

kosmo integrations:call zendesk-sell.zendesk_sell_get_contact '{"id":1}' --json

Provider shortcut

kosmo integrations:zendesk-sell zendesk_sell_get_contact '{"id":1}' --json

`zendesk-sell.zendesk_sell_create_contact`

Write write

Create a new contact in Zendesk Sell. Provide at least a first name and last name. Optionally include email and organization ID to associate the contact with an existing organization.

Parameters: first_name, last_name, email, organization_id

Generic CLI call

kosmo integrations:call zendesk-sell.zendesk_sell_create_contact '{"first_name":"example_first_name","last_name":"example_last_name","email":"example_email","organization_id":1}' --json

Provider shortcut

kosmo integrations:zendesk-sell zendesk_sell_create_contact '{"first_name":"example_first_name","last_name":"example_last_name","email":"example_email","organization_id":1}' --json

`zendesk-sell.zendesk_sell_list_deals`

Read read

List deals in Zendesk Sell. Optionally filter by status (open, won, lost, abandoned). Returns paginated results.

Parameters: page, per_page, status

Generic CLI call

kosmo integrations:call zendesk-sell.zendesk_sell_list_deals '{"page":1,"per_page":1,"status":"example_status"}' --json

Provider shortcut

kosmo integrations:zendesk-sell zendesk_sell_list_deals '{"page":1,"per_page":1,"status":"example_status"}' --json

`zendesk-sell.zendesk_sell_get_deal`

Read read

Get full details of a specific deal in Zendesk Sell by its ID. Returns deal value, status, associated contact and organization, pipeline stage, and custom fields.

Parameters: id

Generic CLI call

kosmo integrations:call zendesk-sell.zendesk_sell_get_deal '{"id":1}' --json

Provider shortcut

kosmo integrations:zendesk-sell zendesk_sell_get_deal '{"id":1}' --json

`zendesk-sell.zendesk_sell_list_leads`

Read read

List leads in Zendesk Sell. Returns paginated results with lead details including contact info, status, and source.

Parameters: page, per_page

Generic CLI call

kosmo integrations:call zendesk-sell.zendesk_sell_list_leads '{"page":1,"per_page":1}' --json

Provider shortcut

kosmo integrations:zendesk-sell zendesk_sell_list_leads '{"page":1,"per_page":1}' --json

`zendesk-sell.zendesk_sell_get_current_user`

Read read

Get the profile of the currently authenticated Zendesk Sell user. Use this to verify credentials and identify the connected account.

Parameters: none

Generic CLI call

kosmo integrations:call zendesk-sell.zendesk_sell_get_current_user '{}' --json

Provider shortcut

kosmo integrations:zendesk-sell zendesk_sell_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`zendesk-sell.zendesk_sell_list_contacts`

List contacts in Zendesk Sell. Returns paginated results sorted by the specified field. Use this to browse, search, or export contacts from the CRM.

Operation: Read read
Schema command: kosmo integrations:schema zendesk-sell.zendesk_sell_list_contacts --json

Parameter	Type	Required	Description
`page`	integer	no	Page number (1-based). Defaults to 1.
`per_page`	integer	no	Number of contacts per page (max 100). Defaults to 25.
`sort_by`	string	no	Field to sort by (e.g. "created_at", "updated_at", "last_name"). Defaults to the API default.

`zendesk-sell.zendesk_sell_get_contact`

Get full details of a specific contact in Zendesk Sell by its ID. Returns all contact fields including email, phone, organization, and custom fields.

Operation: Read read
Schema command: kosmo integrations:schema zendesk-sell.zendesk_sell_get_contact --json

Parameter	Type	Required	Description
`id`	integer	yes	The contact ID.

`zendesk-sell.zendesk_sell_create_contact`

Create a new contact in Zendesk Sell. Provide at least a first name and last name. Optionally include email and organization ID to associate the contact with an existing organization.

Operation: Write write
Schema command: kosmo integrations:schema zendesk-sell.zendesk_sell_create_contact --json

Parameter	Type	Required	Description
`first_name`	string	yes	Contact first name.
`last_name`	string	yes	Contact last name.
`email`	string	no	Contact email address.
`organization_id`	integer	no	ID of the organization to associate this contact with.

`zendesk-sell.zendesk_sell_list_deals`

List deals in Zendesk Sell. Optionally filter by status (open, won, lost, abandoned). Returns paginated results.

Operation: Read read
Schema command: kosmo integrations:schema zendesk-sell.zendesk_sell_list_deals --json

Parameter	Type	Required	Description
`page`	integer	no	Page number (1-based). Defaults to 1.
`per_page`	integer	no	Number of deals per page (max 100). Defaults to 25.
`status`	string	no	Filter by deal status: "open", "won", "lost", or "abandoned".

`zendesk-sell.zendesk_sell_get_deal`

Get full details of a specific deal in Zendesk Sell by its ID. Returns deal value, status, associated contact and organization, pipeline stage, and custom fields.

Operation: Read read
Schema command: kosmo integrations:schema zendesk-sell.zendesk_sell_get_deal --json

Parameter	Type	Required	Description
`id`	integer	yes	The deal ID.

`zendesk-sell.zendesk_sell_list_leads`

List leads in Zendesk Sell. Returns paginated results with lead details including contact info, status, and source.

Operation: Read read
Schema command: kosmo integrations:schema zendesk-sell.zendesk_sell_list_leads --json

Parameter	Type	Required	Description
`page`	integer	no	Page number (1-based). Defaults to 1.
`per_page`	integer	no	Number of leads per page (max 100). Defaults to 25.

`zendesk-sell.zendesk_sell_get_current_user`

Get the profile of the currently authenticated Zendesk Sell user. Use this to verify credentials and identify the connected account.

Operation: Read read
Schema command: kosmo integrations:schema zendesk-sell.zendesk_sell_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.