For Postalytics to properly integrate direct mail with Salesforce using authentication, we’ll need some specific permissions to access key parts of your Salesforce instance. As a starter, your Salesforce edition must have access to the “API functionality feature”, “Flow Builder feature” and the “Outbound Message feature”. Please contact your Salesforce Account Manager for more details about your Salesforce features. According to Salesforce documentation, the following editions have the proper features:

  • Essentials Edition

  • Professional Edition

  • Enterprise Edition

  • Performance Edition

  • Unlimited Edition

  • Developer Edition

The Salesforce Integration User 

We’ll also need a user in your Salesforce instance with some minimum permissions to set up the Postalytics direct mail integration through our simple authentication method. Often, a Salesforce Administrator has either their user permissions already configured to do the integration or can quickly get a user setup in order to perform it. Note – the Salesforce user permissions needed to configure the Postalytics integration (typically done just once) are not needed to perform actual campaigns, once the integration is set up.

The minimum permissions needed on the Salesforce user are:

  • Manage Profiles and Permission Sets

  • Customize Application

  • Modify All Data

By default, the “System Administrator” user can be used for the integration as it already has all the permission needed for Postalytics to function properly in creating and sending update status back to Salesforce.

Scroll to the end of this article to learn how to create a new Salesforce user for the integration. You’ll need to make sure you have an available license if you want to go this route.

Why We Need Permissions In Salesforce 

The Postalytics direct mail integration uses Salesforce APIs to do several things:

  • Import Contacts or Leads as defined in Saved Views, Campaigns and Accounts into Postalytics Lists for Smart Send Campaigns.

  • Communicate the status of the mail delivery and online response in a property that we create for the Contacts or Leads in a Postalytics Campaign.

  • Import Contacts or Leads via Workflows and Outbound Messages into Triggered Drip Campaigns for automated direct mail.

Authenticate Postalytics And Salesforce 

After you’ve determined the right Salesforce username to set up the direct mail integration, head over to Postalytics.

To authenticate Postalytics and Salesforce, log into Postalytics and navigate to the upper right menu below the user name. Choose ‘Connect’, 

And then, ‘Connect App Marketplace’. 

On the following page, select ‘Add Integration’ under the Salesforce icon. 

A popup window will appear with the Salesforce Login page. Use the Salesforce user name that you know has the appropriate privileges. When you’ve completed the login, you’ll be presented with a dialog asking for a name for the integration (you can have multiple integrations if you’re a consultant or agency). Give it a name that will make sense to you down the road, and press “Save”.

You’ve just authenticated Postalytics and Salesforce (using the latest & greatest OAuth 2.0 authentication technology!)

To Create A New Salesforce User For The Postalytics Direct Mail Authentication

If you would like to create a user just for Postalytics usage, you can create a new user with those specific permission as listed above for solo Postalytics use. First, you will need to create a new profile in Salesforce under Setup, then Administration, then Profiles. For the existing Profile, please choose “Standard User” and then enter a profile name. After you have created a new profile and saved it, you will be presented with the details of your newly created profile. You will need to click on the ‘Edit’ button and the scroll down to the “Administrative Permissions” and search and click on the checkbox for the permissions, “Manage Profiles and Permission Sets”, “Customize Application”, and “Modify All Data”, then click on save.

Links for Reference:

https://help.salesforce.com/s/articleView?id=sf.flow.htm&type=5 (Salesforce Flow Builder Documentation)

https://help.salesforce.com/articleView?id=000005140&language=en_US&type=1 (Salesforce editions with API Access)

https://appexchange.salesforce.com/ (AppExchange Information)