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

  1. Connecting Salesforce

  2. Objects & Access

  3. API Information


Connecting Salesforce

To connect your Salesforce account, you'll need to start in Postal and finish Salesforce.

Start in Postal

  1. Go to the Profile Settings section of your account

  2. Click on 'Integrations' and select 'Connect to Salesforce'

    1. If you haven't already please create the API User (follow this Salesforce help article)

    2. If you already have an API user, use those credentials to connect your integration

  3. Authenticate Salesforce & approve the Integration when prompted

  4. 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!

Did this answer your question?