Sales Persons

Sales Person Endpoint Reference

Note: Sales Person APIs are read-only access for subscriptions which have SFDC Sync or Microsoft Dynamics Sync are enabled.  Sales Persons are a type of person record that are the sales owners of lead records.  They are related to Lead records by the externalSalesPersonId field on each Lead record.  When a Lead is related to a Sales Person by a populated externalSalesPersonId field, the corresponding Lead Owner lookup fields are populated for that lead record in Marketo, allowing usage of the corresponding filters and tokens.

Sales Persons are related to Lead records by using the Sync Leads endpoint and passing the externalSalesPersonId attribute.

Sales Persons are related to Opportunity records by using the Sync Opportunities endpoint and passing the externalSalesPersonId attribute.

Sales Persons are related to Company records by using the Sync Companies endpoint and passing the externalSalesPersonId attribute.

Sales Person records are only editable via the API.

Describe

Describing Sales Person records follows the standard pattern for lead database objects.

By default, the idField of Sales Persons is “id” and the dedupeFields is just “externalSalesPersonId.”

Query

Sales Persons using the standard query pattern for simple keys.  This example shows the user’s email being used as the externalSalesPersonId.  By default the query will return all fields that are populated for the returned records.

Create and Update

The pattern for updates is standard.

Delete

The pattern for deletes is standard.

Deletion of Sales Persons are not allowed when “in use”.   In this case the Sales Person is skipped.  Examples:

  • When Sales Person is associated with active Leads
  • When Sales Person is associated with a Company that has been deleted

Timeouts

  • Sales Person Endpoints have a timeout of 30s unless noted below
    • Sync Sales Persons: 60s
    • Delete Sales Persons: 60s