Skip to main content
All CollectionsIntegrations
Import and update Salesforce contacts in Retently via an inbound webhook link
Import and update Salesforce contacts in Retently via an inbound webhook link
Alex Bitca avatar
Written by Alex Bitca
Updated over 6 months ago

Retently has a native integration with Salesforce that can be used to automatically sync all your contacts to Retently on a daily basis. However, due to performance concerns, the integration will not allow you to activate the automated sync if your contacts number in Salesforce exceeds 10,000 records.

In this case, you can apply our webhook solution to make sure that your contacts are automatically imported and updated to Retently.

To briefly explain how the solution would work:

  • You will need to generate a webhook link in Retently.

  • Next, you will have to create a Workflow Rule in Salesforce to specify what contacts are eligible to be imported to Retently.

  • Finally, you will have to add "Outbound Message" as your Salesforce Workflow Action, where you will be asked to provide Retently's webhook link that will handle the contacts' import and update in Retently.

Note: Salesforce has deprecated the Workflow Rules feature. Consider using Salesforce Flows instead. You can learn more about them here.

I will cover these steps in detail below.

Generate a webhook link in Retently

You can create a new webhook URL on the Inbound Webhooks page. When creating a new URL, make sure to select the following options:

  • Integrations: Salesforce

  • Scope: Create or update contact

Finally, copy the webhook URL as you will soon need it.

Create a Salesforce Workflow Rule

The next step is to create a Workflow Rule in your Salesforce account, where you will specify what contacts should be sent to Retently.

Log into your Salesforce account, and access the Setup area, where you will need to create a new Workflow Rule.

Select “Contact” as the object to which this workflow applies:

On the next step, give your rule a name, for instance, “Contacts for Retently”. Then, select the “created, and every time it's edited” option as the evaluation criteria.

Finally, for your rule criteria, set filters to choose a specific segment of your contacts that should be added to Retently, and click "Save" to go to the next step.

Add "Outbound Message" and your Workflow action

Once you have saved the Workflow Rule, on the new screen that appears, under "Immediate Workflow Actions" use the "Add Workflow Action" drop-down, and choose "New Outbound Message":

The most important part here is to include the Retently webhook link that was generated in your campaign’s Setup section. Include the link in the “Endpoint URL” input field.

Next, choose the properties that you want to send to Retently along with your contact record.

NOTE: The only mandatory property is the email address of your contact.

You can also pass other Salesforce properties as well. For this you will need to:

  • Select the property from the "Available Fields" and add it to the "Selected Fields" in your "Outbound Message" builder.

  • Make sure you have this property in Retently so that our system can match it automatically when the contact will be added. The property in Retently should have the exact name as the property in Salesforce. Therefore, you can simply copy the Salesforce property name from this page and create an identical one in Retently (and make sure the Retently property also has the correct property type: text, number, date). For example, if you want to push to Retently the "Sign_up__c" Salesforce property, then you should have an identical one in Retently.

Finally, save your Outbound message and make sure that your Workflow Rule is active.

From now on, every time a contact will match your workflow rule criteria, the outbound message will pass the data through the Retently webhook link and the contact will be created (or updated) in Retently.

Did this answer your question?