Skip to main content

Zendesk Sell Connector

Zendesk Sell Zendesk Sell is a sales force automation and CRM platform. This component allows you to manage leads, contacts, and deals in Zendesk Sell.

API Documentation

This component was built using the Zendesk Sell API.

Connections

OAuth 2.0

Authenticate using OAuth 2.0.

Create a connection of type OAuth 2.0 to authenticate with the Zendesk Sell API using OAuth 2.0.

Prerequisites

  • A Zendesk Sell account with administrator access

Setup Steps

  1. Log in to the Zendesk Sell Dashboard at a URL similar to https://{subdomain}.zendesk.com/sales/dashboards/main.
  2. On the left-hand side toolbar, click Settings.
  3. Within the Settings section, navigate to Integrations > OAuth.
  4. Under the OAuth section, open OAuth2 Settings.
  5. In the Developer apps section, click Add Developer App.
  6. Complete the required fields for the app setup. Specify the Redirect URL as https://oauth2.integrations.acme.com/callback.
  7. Once the app has been added, select the details button associated with the app to retrieve the Client ID and Client Secret.

Configure the Connection

  • For Authorize URL, the default value is https://api.getbase.com/oauth2/authorize. Update if using a custom Zendesk Sell instance.
  • For Token URL, the default value is https://api.getbase.com/oauth2/token. Update if using a custom Zendesk Sell instance.
  • For Scopes, the default value is read write profile. Adjust based on the required level of access.
  • Enter the Client ID obtained from the developer app details.
  • Enter the Client Secret obtained from the developer app details.

This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works here.

InputCommentsDefault
Authorize URLThe OAuth 2.0 authorization endpoint for Zendesk Sell.https://api.getbase.com/oauth2/authorize
Token URLThe OAuth 2.0 token endpoint for Zendesk Sell.https://api.getbase.com/oauth2/token
ScopesThe space-delimited OAuth 2.0 scopes to request. Defaults to read, write, and profile access.read write profile
Client IDThe client ID obtained from the Zendesk Sell OAuth application settings.
Client SecretThe client secret obtained from the Zendesk Sell OAuth application settings.

Actions

Create Contact

Creates a new contact. A contact may represent a single individual or an organization.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
NameRequired only if the contact is an organization. is_organization is set to true.
First NameThe field will be set only if the contact is an individual. is_organization is set to false.
Last NameRequired only if the contact is an individual. is_organization is set to false.
Owner IDDefaults to the unique identifier of the user who created the contact.
Is OrganizationThis value can be set only during creation and cannot be changed later.
Contact IDThe field will be set only if the contact is an individual. is_organization is set to false.
Parent Organization IDThe unique identifier of a contact that should be set as parent for this organization. Referenced contact also has to be an organization. It can be set only for organization contacts (is_organization set to true).
Customer StatusCustomer status of the contact. Possible values: none, current, past.
Prospect StatusProspect status of the contact. Possible values: none, current, lost.
TitleJob title of the contact.
DescriptionAdditional notes or details about the contact.
IndustryIndustry classification of the contact.
WebsiteWebsite URL of the contact.
EmailEmail address of the contact.
PhonePhone number of the contact.
MobileMobile phone number of the contact.
FaxFax number of the contact.
TwitterTwitter username of the contact.
FacebookFacebook username of the contact.
LinkedInLinkedIn username of the contact.
SkypeSkype username of the contact.
AddressPhysical address of the contact.
Billing AddressBilling address of the contact. null if contact is neither a customer nor a prospect (see customer_status and prospect_status fields for details).
Shipping AddressShipping address of the contact. null if contact is neither a customer nor a prospect (see customer_status and prospect_status fields for details).
TagTags to apply to the contact. You need to supply the entire set.
Custom FieldFilterable custom field key-value pairs.

Create Deal

Creates a new deal.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
NameName of the deal.
Contact IDThe unique identifier of the primary contact associated with the deal.
ValueValue of the deal in decimal format (e.g., two decimal places).
CurrencyThe currency code for the deal value. If omitted, the account default currency is used.
Owner IDDefaults to the unique identifier of the user that the deal is created by.
HotIndicator of whether or not the deal is hot.
Stage IDIf omitted, the deal will be placed in the first stage of the default pipeline.
Last Stage Change AtDate and time when the deal was moved into the current stage in UTC (ISO8601 format).
Added AtDate and time that the deal was started in UTC (ISO8601 format).
Source IDID of the deal Source.
Loss Reason IDID of the Loss Reason.
Unqualified Reason IDID of the Unqualify Reason.
Estimated Close DateExpected date when the deal will close.
Customized Win LikelihoodUser-provided win likelihood with value range 0-100.
TagTags to apply. You need to supply the entire set.
Custom FieldFilterable custom field key-value pairs.

Create Lead

Creates a new lead.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Last NameRequired only if a lead is an individual. company_name is empty.
Organization NameRequired only if a lead is an organization. last_name is empty.
First NameFirst name of the contact.
Owner IDDefaults to user's unique identifier of the user who created the lead is created by.
StatusStatus of the lead.
Source IDThe unique identifier of the lead source.
Unqualified Reason IDThe unique identifier of the reason the lead was unqualified.
TitleJob title or role.
DescriptionDescription or notes.
IndustryIndustry classification.
WebsiteWebsite URL.
EmailEmail address.
PhonePhone number.
MobileMobile phone number.
FaxFax number.
TwitterTwitter username.
FacebookFacebook username.
LinkedInLinkedIn username.
SkypeSkype username.
AddressThe physical address of the lead in JSON format.
TagTags to apply. You need to supply the entire set.
Custom FieldFilterable custom field key-value pairs.

Create Note

Creates a new note and associates it with one resource.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Resource TypeThe type of resource the note is attached to. Possible values: lead, contact, deal.
Resource IDThe unique identifier of the resource the note is attached to.
ContentThe body text of the note.
Is ImportantWhen true, marks the note as important.
TagTags to apply to the note.
TypeThe type of note. Possible values: regular or other types supported by the API.

Create Order

Creates a new order.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Deal IDThe unique identifier of the deal.
DiscountOverall discount on the order in percents. Defaults to 0.

Create Task

Creates a new task.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
ContentThe description or body of the task.
Due DateThe date and time when the task is due. Format: ISO8601 UTC.
Owner IDDefaults to the unique identifier of the user who created the task.
Resource TypeThe type of resource the task is related to. Possible values: lead, contact, deal.
Resource IDThe unique identifier of the resource the task is related to.
CompletedWhen true, marks the task as completed.
Remind AtThe date and time to send a reminder for this task. Format: ISO8601 UTC.

Delete Contact

Deletes an existing contact. This operation cannot be undone.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Contact IDThe unique identifier of the contact to delete.

Delete Deal

Deletes an existing deal and removes all associated contacts from the deal in a single call.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Deal IDThe unique identifier of the deal to delete.

Delete Lead

Deletes an existing lead.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Lead IDThe unique identifier of the lead to delete.

Delete Note

Deletes an existing note. This operation cannot be undone.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Note IDUnique identifier of the note.

Delete Order

Deletes an existing order and removes all associated line items in a single call. This operation cannot be undone.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Order IDThe unique identifier of the order to delete.

Delete Task

Deletes an existing task. This operation cannot be undone.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Task IDThe unique identifier of the task to delete.

Get Contact

Returns a single contact available to the user, according to the unique contact ID provided.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Contact IDThe unique identifier of the contact to retrieve.

Get Contacts Stream

Reads the stream of contact events.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
PositionThe client position in the Firehose stream. Possible values: top, tail, or a position string from a previous API response.
LimitThe maximum number of events to return in a single response.

Get Custom Fields Stream

Reads the stream of custom field events.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
PositionThe client position in the Firehose stream. Possible values: top, tail, or a position string from a previous API response.
LimitLimits maximum number of events in single response.

Get Deal

Returns a single deal available to the user.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Deal IDThe unique identifier of the deal to retrieve.
IncludesComma-separated list of one or more resources related to the deal. Possible values: associated_contacts.

Get Deals Stream

Reads the stream of deal events.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
PositionThe client position in the Firehose stream. Possible values: top, tail, or a position string from a previous API response.
LimitThe maximum number of events to return in a single response.

Get Lead

Returns a single lead available to the user.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Lead IDThe unique identifier of the lead to retrieve.

Get Leads Stream

Reads the stream of lead events.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
PositionThe client position in the Firehose stream. Possible values: top, tail, or a position string from a previous API response.
LimitThe maximum number of events to return in a single response.

Get Note

Returns a single note available to the user, according to the unique note ID provided.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Note IDThe unique identifier of the note.

Get Notes Stream

Reads the stream of note events.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
PositionThe client position in the Firehose stream. Possible values: top, tail, or a position string from a previous API response.
LimitThe maximum number of events to return in a single response.

Get Order

Returns a single order available to the user.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Order IDThe unique identifier of the order to retrieve.

Get Orders Stream

Reads the stream of order events.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
PositionThe client position in the Firehose stream. Possible values: top, tail, or a position string from a previous API response.
LimitThe maximum number of events to return in a single response.

Get Products Stream

Reads the stream of product events.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
PositionThe client position in the Firehose stream. Possible values: top, tail, or a position string from a previous API response.
LimitLimits maximum number of events in single response.

Get Stages Stream

Reads the stream of stage events.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
PositionThe client position in the Firehose stream. Possible values: top, tail, or a position string from a previous API response.
LimitThe maximum number of events to return in a single response.

Get Stream

Provides a stream of changes to Zendesk Sell data.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
ResourceThe resource to get the stream for.
PositionThe client position in the Firehose stream. Possible values: top, tail, or a position string from a previous API response.
LimitLimits maximum number of events in single response.

Get Task

Returns a single task available to the user according to the unique task ID provided.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Task IDThe unique identifier of the task to retrieve.

Get Tasks Stream

Reads the stream of task events.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
PositionThe client position in the Firehose stream. Possible values: top, tail, or a position string from a previous API response.
LimitThe maximum number of events to return in a single response.

List Account Details

Retrieves account details.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.

List Contacts

Returns all contacts available to the user according to the parameters provided.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
PageThe page number to start from. Page numbering is 1-based and omitting the page parameter will return the first page.
Per PageThe number of records to return per page. Default limit is 25 and maximum number that can be returned is 100.
Sort ByA field to sort by. You can sort by filterable custom fields as well.
IDsComma-separated list of the IDs for the contacts you want to be returned in your request.
Creator IDUser ID. Returns all contacts created by that user.
Owner IDUser ID. Returns all contacts owned by that user.
Is OrganizationIndicates whether or not this contact refers to an organization or an individual.
Contact IDThe unique identifier of the organization that the contact belongs to.
NameName of the contact.
First NameFirst name of the contact.
Last NameLast name of the contact.
EmailEmail address of the contact.
PhonePhone number of the contact.
MobileMobile phone number of the contact.
Customer StatusCustomer status of the contact. Possible values: none, current, past
Prospect StatusProspect status of the contact. Possible values: none, current, lost
Address (City)City name.
Address (Postal Code)Zip code or equivalent
Address (Country)Country name.
Address (State)State/region name.
Billing Addressnull if contact is neither a customer nor a prospect (see customer_status and prospect_status fields for details).
Shipping Addressnull if contact is neither a customer nor a prospect (see customer_status and prospect_status fields for details).
Custom FieldFilterable custom field key-value pairs.
InclusiveIndicates how filters should be combine. true value, the default, uses AND logic. false value uses OR logic to combine filters.

List Custom Fields

Returns all custom fields associated with the specified resource type.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Resource TypeSpecifies the type for which custom fields should be returned.

List Deals

Returns all deals available to the user.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
PagePage number to start from. Page numbering starts at 1, and omitting the page parameter will return the first page.
Per PageNumber of records to return per page. Default limit is 25 and the maximum number that can be returned is 100.
Sort ByA field to sort by. You can sort by filterable custom fields as well.
IDsComma-separated list of deal IDs to be returned in a request.
IncludesComma-separated list of one or more resources related to a deal.
Creator IDUnique identifier of the user the deal was created by. Returns all deals created by the user.
Owner IDUnique identifier of the user the deal is owned by. Returns all deals owned by the user.
Contact IDUnique identifier of a primary contact.
Organization IDUnique identifier of an organization.
HotIndicator of whether or not the deal is hot.
Source IDID of the Source.
Stage IDID of the Stage.
NameName of the deal.
ValueValue of the deal. We encourage you to use a string with two decimal places.
Estimated Close DateEstimated close date of the deal.
Custom FieldFilterable custom field key-value pairs.
InclusiveIndicates how filters should be combine. true value, the default, uses AND logic. false value uses OR logic to combine filters.

List Leads

Returns all leads available to the user.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
PagePage number to start from. Page numbering starts at 1 and omitting the page parameter will return the first page.
Per PageNumber of records to return per page. The default limit is 25 and the maximum number that can be returned is 100.
Sort ByA field to sort by. You can sort by filterable custom fields as well.
IDsComma-separated list of lead IDs to be returned in a request.
Creator IDUser ID. Returns all leads created by that user.
Owner IDUser ID. Returns all leads owned by that user.
Source IDID of the Source.
First NameFirst name of the lead.
Last NameLast name of the lead.
Organization NameOrganization name of the lead.
StatusStatus of the lead.
EmailEmail address of the lead.
PhonePhone number of the lead.
MobileMobile phone number of the lead.
Address[city]City name.
Address[postal Code]Zip or Postal code.
Address[state]State/region name.
Address[country]Country name.
Custom FieldFilterable custom field key-value pairs.
InclusiveIndicates how filters should be combine. true value, the default, uses AND logic. false value uses OR logic to combine filters.

List Notes

Returns all notes available to the user, according to the parameters provided.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
PagePage number to start from. Page numbering starts at 1, and omitting the page parameter will return the first page.
Per PageNumber of records to return per page. The default limit is 25 and the maximum number that can be returned at one time is 100.
Sort ByA field to sort by. Default ordering is ascending. If you want to change the sort ordering to descending, append :desc to the field e.g. sort_by=resource_type:desc. Possible values, resource_type, created_at, updated_at
IncludesComma-separated list of one or more resources related to the note. Not supported at the moment.
IDsComma-separated list of note IDs to be returned in a request.
Creator IDUnique identifier of the user. Returns all notes created by the user.
QA query string to search for. Performs a full text search on the content field.
Resource TypeName of the type of resource to search for. Possible values: lead, contact, deal
Resource IDUnique identifier of the resource to search for.

List Orders

Returns all orders available to the user.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
PagePage number to start from. Page numbering starts at 1, and omitting the page parameter will return the first page.
Per PageNumber of records to return per page. Defaults to 25. Maximum is 500.
IDsComma-separated list of IDs to be returned in request.
Sort ByA field to sort by. Default ordering is ascending. If you want to change the sort ordering to descending, append :desc to the field.
Deal IDID of the deal order is associated to.

List Pipelines

Returns all pipelines available to the user, according to the parameters provided.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
PagePage number to start from. Page numbering starts at 1, and omitting the page parameter will return the first page.
Per PageNumber of records to return per page. Default limit is 25 and the maximum number that can be returned is 100.
IDsComma-separated list of IDs to be returned in request.
Sort ByComma-separated list of fields to sort by. The sort criteria is applied in the order specified. The default ordering is ascending. If you want to change the sort ordering to descending, append :desc to the field.
NameName of the pipeline to search for. This parameter is used in a strict sense.
DisabledParameter that determines whether to return disabled or enabled pipelines.

List Stages

Returns all stages available to the user.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Pipeline IDThe unique identifier of the pipeline that contains this stage.
PageThe page number to start from. Page numbering starts at 1, and omitting the page parameter will return the first page.
Per PageThe number of records to return per page. The default limit is 25 and the maximum number that can be returned is 100.
Sort ByComma-separated list of fields to sort by. The sort criteria is applied in the order specified. The default ordering is ascending. If you want to change the sort ordering to descending, append :desc to the field. Possible values: pipeline_id, id, name, category, position, likelihood
IDsComma-separated list of stage IDs to be returned in a request.
NameName of the stage you're searching for. This parameter is used in a strict sense.
ActiveParameter that determines whether to return active or inactive stages.

List Tasks

Returns all tasks available to the user.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
PagePage number to start from. Page numbering starts at 1 and omitting the page parameter will return the first page.
Per PageNumber of records to return per page. The default limit is 25 and the maximum number that can be returned is 100.
Sort ByA field to sort by. The default ordering is ascending. If you want to change the sort order to descending, append :desc to the field
IDsComma-separated list of task IDs to be returned in a request.
Creator IDUnique identifier of the user. Returns all tasks created by the user.
Owner IDUnique identifier of the user. Returns all tasks owned by the user.
QA query string to search for. Performs a full text search on the content field.
TypeType of tasks to search for. Possible values: floating, related
Resource TypeName of the resource type to search for. Possible values: lead, contact, deal
Resource IDUnique identifier of the resource that you're searching for.
CompletedIndicates whether the query will return tasks that are completed or not.
OverdueIndicates whether the query will return tasks where the due_date parameter has been passed or not.
RemindIndicates whether the query will return tasks with reminders or without reminders.

Raw Request

Sends a raw HTTP request to the Zendesk Sell API.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
URLThis is the URL to call.
MethodThe HTTP method to use.
DataThe HTTP body payload to send to the URL.
Form DataThe Form Data to be sent as a multipart form upload.
File DataFile Data to be sent as a multipart form upload.
File Data File NamesFile names to apply to the file data inputs. Keys must match the file data keys above.
Query ParameterA list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
HeaderA list of headers to send with the request.
Response TypeThe type of data you expect in the response. You can request json, text, or binary data.json
TimeoutThe maximum time that a client will await a response to its request
Debug RequestEnabling this flag will log out the current request.false
Retry Delay (ms)The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.0
Retry On All ErrorsIf true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.false
Max Retry CountThe maximum number of retries to attempt. Specify 0 for no retries.0
Use Exponential BackoffSpecifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.false
API VersionThe version of the API to use.v2

Update Contact

Updates contact information. If the specified contact does not exist, the request will return an error.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
IDThe unique identifier of the contact.
NameThis field will be set only if the contact is an organization. is_organization is set to true.
First NameThe field will be set only if the contact is an individual. is_organization is set to false.
Last NameThe field will be set only if the contact is an individual. is_organization is set to false.
Contact IDThe field will be set only if the contact is an individual. is_organization is set to false.
Parent Organization IDThe unique identifier of a contact that should be set as parent for this organization. Setting this to null will clear existing parent relation. Referenced contact also has to be an organization. It can be set only for organization contacts (is_organization set to true).
Owner IDThe unique identifier of the user who owns the contact.
Customer StatusCustomer status of the contact. Possible values: none, current, past.
Prospect StatusProspect status of the contact. Possible values: none, current, lost.
TitleJob title of the contact.
DescriptionAdditional notes or details about the contact.
IndustryIndustry classification of the contact.
WebsiteWebsite URL of the contact.
EmailEmail address of the contact.
PhonePhone number of the contact.
MobileMobile phone number of the contact.
FaxFax number of the contact.
TwitterTwitter username of the contact.
FacebookFacebook username of the contact.
LinkedInLinkedIn username of the contact.
SkypeSkype username of the contact.
AddressPhysical address of the contact.
Billing AddressBilling address of the contact. Can be updated if contact is either a customer or a prospect (see customer_status and prospect_status fields for details).
Shipping AddressShipping address of the contact. Can be updated if contact is either a customer or a prospect (see customer_status and prospect_status fields for details).
TagTags to apply to the contact. You need to supply the entire set.
Custom FieldFilterable custom field key-value pairs.

Update Deal

Updates deal information.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Deal IDThe unique identifier of the deal to update.
NameName of the deal.
ValueValue of the deal in decimal format (e.g., two decimal places).
CurrencyThe currency code for the deal value. If omitted, the account default currency is used.
Owner IDThe unique identifier of the user who owns the deal.
HotWhen true, marks the deal as hot.
Stage IDThe unique identifier of the pipeline stage for this deal.
Last Stage Change AtDate and time when the deal was moved into the current stage in UTC (ISO8601 format).
Added AtDate and time that the deal was started in UTC (ISO8601 format).
Source IDID of the deal Source.
Loss Reason IDID of the Loss Reason.
Unqualified Reason IDID of the Unqualify Reason.
Contact IDUnique identifier of a primary contact.
Estimated Close DateExpected date when the deal will close.
Customized Win LikelihoodUser-provided win likelihood with value range 0-100.
TagTags to apply. You need to supply the entire set.
Custom FieldFilterable custom field key-value pairs.

Update Lead

Updates lead information.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Lead IDThe unique identifier of the lead to update.
Owner IDThe unique identifier of the user who owns the lead.
First NameFirst name of the contact.
Last NameThe last name of the lead.
Organization NameThe name of the organization for organization-type leads.
StatusStatus of the lead.
Source IDThe unique identifier of the lead source.
Unqualified Reason IDThe unique identifier of the reason the lead was unqualified.
TitleJob title or role.
DescriptionDescription or notes.
IndustryIndustry classification.
WebsiteWebsite URL.
EmailEmail address.
PhonePhone number.
MobileMobile phone number.
FaxFax number.
TwitterTwitter username.
FacebookFacebook username.
LinkedInLinkedIn username.
SkypeSkype username.
AddressThe physical address of the lead in JSON format.
TagTags to apply. You need to supply the entire set.
Custom FieldFilterable custom field key-value pairs.

Update Note

Updates note information.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Resource TypeThe type of resource the note is attached to. Possible values: lead, contact, deal.
Resource IDThe unique identifier of the resource the note is attached to.
ContentThe body text of the note.
Is ImportantWhen true, marks the note as important.
TagTags to apply to the note.
TypeThe type of note. Possible values: regular or other types supported by the API.

Update Order

Updates order information.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Order IDThe unique identifier of the order to update.
DiscountOverall discount on the order in percents.

Update Task

Updates task information.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Task IDThe unique identifier of the task to update.
ContentThe description or body of the task.
Due DateThe date and time when the task is due. Format: ISO8601 UTC.
Owner IDDefaults to the unique identifier of the user who created the task.
Resource TypeThe type of resource the task is related to. Possible values: lead, contact, deal.
Resource IDThe unique identifier of the resource the task is related to.
CompletedWhen true, marks the task as completed.
Remind AtThe date and time to send a reminder for this task. Format: ISO8601 UTC.

Upsert Contact

Creates a new contact or updates an existing one based on a filter value or set of filters. At least one filter query parameter is required.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Creator IDUser ID. Returns all contacts created by that user.
Owner IDUser ID. Returns all contacts owned by that user.
Is OrganizationIndicates whether or not this contact refers to an organization or an individual.
Contact IDThe unique identifier of the organization that the contact belongs to.
Parent Organization IDThe unique identifier of a contact that should be set as parent for this organization. Setting this to null will clear existing parent relation. Referenced contact also has to be an organization. It can be set only for organization contacts (is_organization set to true.
NameName of the contact.
First NameFirst name of the contact.
Last NameLast name of the contact.
EmailEmail address of the contact.
PhonePhone number of the contact.
MobileMobile phone number of the contact.
Customer StatusCustomer status of the contact. Possible values: none, current, past
Prospect StatusProspect status of the contact. Possible values: none, current, lost
Address (City)City name.
Address (Postal Code)Zip code or equivalent
Address (Country)Country name.
Billing AddressCan be updated if contact is either a customer or a prospect (see customer_status and prospect_status fields for details).
Shipping AddressCan be updated if contact is either a customer or a prospect (see customer_status and prospect_status fields for details).
Custom FieldFilterable custom field key-value pairs.
FilterFilterable custom field.
InclusiveIndicates how filters should be combine. true value, the default, uses AND logic. false value uses OR logic to combine filters.

Upsert Lead

Creates a new lead or updates an existing one based on a filter value or set of filters.

InputCommentsDefault
ConnectionThe Zendesk Sell connection to use.
Creator IDUser ID. Returns all leads created by that user.
Owner IDUser ID. Returns all leads owned by that user.
Source IDID of the Source.
First NameFirst name of the lead.
Last NameLast name of the lead.
Organization NameOrganization name of the lead.
StatusStatus of the lead.
EmailEmail address of the lead.
PhonePhone number of the lead.
MobileMobile phone number of the lead.
Address[city]City name.
Address[postal Code]Zip or Postal code
Address[country]Country name.
Custom FieldFilterable custom field key-value pairs.
FilterFilterable custom field.
InclusiveIndicates how filters should be combine. true value, the default, uses AND logic. false value uses OR logic to combine filters.