Introduction

This document lists the events and objects that you can use to build apps in Zendesk Sell. This API is supplemented by the Core Apps API available to all Zendesk apps.

If you're just getting started, see Building your first Sell app.

Each app lives in a location in the Zendesk Sell user interface. The location defines what the app can do as follows:

  • All locations share a common set of events, properties, and actions
  • Each location has additional events, properties, and actions

See the following location docs for the events, properties, and actions you can use in each location.

LocationDescription
all locationsAll listed locations
lead cardPanel on the right side of the Lead card
company cardPanel on the right side of the Company card
person cardPanel on the right side of the Person card
deal cardPanel on the right side of the Deal card
top barRight side of the bar on the upper side
backgroundNo UI. Always running in the background to receive special events
modalModal dialog
note editorToolbar on the lower side of the note editor
call log editorToolbar on the lower side of the call log editor
visit editorToolbar on the lower side of the visit editor

image

To specify the location for your app, see Setting the app location.

If you specify top_bar, note_editor, call_log_editor or visit_editor, the app appears as an icon in the location. Clicking the icon opens the app.

Use the ZAF client in your app to listen for events, invoke actions, and access properties.