This article dives into how to integrate Salesforce with your Postal account.
Note: You will need to have Admin access in both Postal & Salesforce to complete the integrations setup.
Contents
Connecting Salesforce
To connect your Salesforce account, you'll need to start in Postal and finish Salesforce.
Start in Postal
Go to the Profile Settings section of your account
Click on 'Integrations' and select 'Connect to Salesforce'
If you haven't already please create the API User (follow this Salesforce help article)
If you already have an API user, use those credentials to connect your integration
Authenticate Salesforce & approve the Integration when prompted
Select which objects are the most applicable to you and your team you want to map between the two platforms.
Salesforce
Now in Salesforce:
Make sure the Marketing User checkbox is checked so the campaign integration works
You will need to select the object "Task" and in the "Type" field, enter "Postal" as an active value in the picklist
Salesforce sends the following contact information to Postal:
First Name, Last Name
Email Address
Title
Company
Phone Number
Contact Owner
Objects & Access
What fields get set automatically during Task creation?
With the standard integration, the fields on the Task Object that are set automatically when a Task gets created to indicate an Item was sent are:
WhoId
OwnerId
Type=Postal
Subject
Description
ActivityDate
Priority=Normal
Status=Completed
IsReminderSet=false
SFDC Object | Access | Reason |
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 in 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. |
Task | Create | We create tasks when actions occur in Postal. |
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 |
API Information
We query SFDC every 15 minutes for contacts/lead/accounts updates. Each one of these requests is an SFDC API call. Additionally, when we push a task to SFDC due to a related action in Postal, there is an SFDC API call. Using campaign mappings also adds additional SFDC API calls.
We have no limits on these API calls to SFDC but many customers do have an SFDC limit. We’ve tried to restrict the number of calls to SFDC.
SFDC Managed Package
The SFDC Managed Package can be added to Salesforce to create a deeper integration experience and is required to use Triggers with Postal. This app can be found in the AppExchange and will cost $1. For more information on the Salesforce Managed Package, check out this article!
Note: the SFDC Managed Package supports Enterprise, Performance, Unlimited, Developer, and Database.com Editions.
For additional assistance, please reach out to our Support Team!