This article outlines the access Postal requires as well as any custom fields that need to be created to ensure your Salesforce Integration runs smoothly.
Object Access & Reasoning
Postal requires access to various Salesforce Objects. Here is a breakdown of the reasoning and exact fields.
Object |
Access |
Reason |
Fields |
Lead |
Read/Write |
We read leads to load in the lead's profile data. We update custom fields on the lead to help with ROI reporting. |
|
Contact |
Read/Write |
We read contacts to load the contact's profile data. We update custom fields on the contact to help with ROI reporting. |
|
Account |
Read/Write |
We read accounts so we can associate the account name with your contacts in Postal. We update custom fields on the account to help with ROI reporting. |
|
User |
Read/Write |
Assign Contact ownership based on Salesforce and sync Users to Postal. |
|
Task |
Create |
We create tasks when actions occur in Postal. Note: the picklist value Postal must be created for the Type field. |
|
Campaign |
Read |
Our UI needs to load a list of campaigns so we can allow a user to select which campaign to map an item to. |
|
Campaign Member |
Read/Write |
We need to be able to associate and update campaign member statuses when items are sent |
|
Opportunity |
Read |
We read opportunities to help report on ROI and for trigger filters |
|
Event |
Read |
We read events to allow triggering off the event object |
|
Note! The picklist value Postal must be created for the Type field.
Good to know!
You can avoid common sending issues by checking to see that the API Integration user is able to access all of the above objects and fields. See the Field Level Security Permissions article from Salesforce.
Custom Field Creation
Postal will automatically create the following fields when installing the Salesforce Managed Package:
Object |
Access |
Reasoning |
Fields |
Account |
Read/Write |
Surface the total spend associated with your accounts |
|
Contact |
Read/Write |
Surface various data points to the Contact. |
|
Lead |
Read/Write |
Surface various data points to the Lead. |
|
Task |
Read/Write |
Surface various data points to the Task. |
|
Definitions
- Postal Touches = count of items sent
- Lead Cost/Contact Cost = total cost of items sent to that lead/contact
- Cost Per Touch = average cost of items sent to that lead/contact
Best Practice! Organize your layouts to keep all the Postal fields together in one section.
Manual Field Creation
Postal ABM requires custom fields to be created. Please see our Syncing Postal Account Data to Salesforce article for more information.
Explore the Postal + Salesforce integration using our Salesforce Integration Hub article!