Skip to content

Outreach

This Integration requires Fides Cloud or Fides Enterprise. For more information, talk to our solutions team. (opens in a new tab)

Outreach (opens in a new tab) is a sales engagement platform that helps sales teams effectively communicate with prospects and customers through personalized, automated outreach.

Prerequisites

To integrate with Outreach, you'll need to setup a custom Outreach app. This ensures exclusive data control, enhances security by reducing unauthorized access risks, and allows customization of scopes and permissions to suit your business needs and policies.

To configure a custom Outreach app using OAuth 2.0 for authentication, please follow this Outreach guide (opens in a new tab).

Once you have this configured, you'll need to collect the following information:

NameDescription
Domain*Your Outreach domain (default: api.outreach.io)
Requester email*The email address of the Outreach user that created your custom app
Client ID*The OAuth 2.0 client ID for your application. For more info, see the Outreach OAuth guide (opens in a new tab)
Client secret*The OAuth 2.0 client secret. For more info, see the Outreach OAuth guide (opens in a new tab)
Redirect URL*The Fides URL to which users will be redirected upon successful authentication (ex. https://fides-host.com/oauth/callback)
Page size*The number of results to return on each page.
Webhook secret*The Outreach webhook secret (opens in a new tab). Leave a random string if not using consent-automation
Your Outreach app will need the following scopes: complianceRequests - All, prospects - All, recipients - All, Webhooks - All and roles - All

Integrating with Outreach

To integrate an existing system with Outreach:

  1. Navigate to Data mapView Systems and choose the system that you want to connect.
  2. Click on the Integrations tab.
  3. Pick the vendor or system type that you want to integrate with from the Connection type drop-down menu.
  4. Complete the required fields for the integration and click Save.

To authorize the integration so that it can connect to Outreach:

  1. Click on Authorize integration to be redirected to the Outreach authorization screen
  2. Enter your credentials and click Log in. You will automatically be redirected back to the Fides UI using the Redirect URL that was provided in the form in the previous step.

You may now confirm your connection is working using the Test connection button, if desired.

To learn more, please see our guide for Managing Integrations.

Consent automation

Outreach also supports consent automation. To configure this, click on the Consent Automation accordion under the Outreach configuration form. This section allows you to map Privacy Notices in Fides to Channels in Outreach. In the example below, setting Marketing for the Marketing information subscription will automatically subscribe and unsubscribe the user from that subscription if they opt-in or out of the Marketing privacy notice in Fides.

Consent automation mappings

Follow this guide to set up communication preferences on outreach (opens in a new tab).

Consent webhooks

Outreach also supports Webhooks (opens in a new tab) so we can use that functionality to post privacy preferences to Fides.

On your Outreach configuration there is a parameter called Webhook secret. this secret will be used by Outreach to authenticate the webhook call.

  1. Using the Outreach API. Make a call to the Create a new webhook endpoint (opens in a new tab).
curl --location 'https://api.outreach.io/api/v2/webhooks' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data '{
    "data": {
        "attributes": {
            "action": "updated",
            "active": true,
            "resource": "prospect",
            "secret": "{your outreach Webhook secret}",
            "url": "https://your_fides_url/api/v1/plus/connection/{{integration_identifier}}/consent-webhook"
        },
        "type": "webhook"
    }
}'

Make sure the webhook URL is reachable via the public internet

By configuring this system webhook. Any subscribe and unsubscribe preferences that happen inside of Outreach will be automatically forwarded and stored within Fides.

Technical detail

Fides utilizes API endpoints to access the API service for a SaaS application. An API service is the programmatic interface through which Fides can query and update data within an application to access, rectify, or delete personal information. Each SaaS tool will have a unique set of endpoints to enable privacy functions.

Fides will report a successful Erasure after having successfully submitted a request to Outreach to erase a Data Subject's data. Outreach may take some time to reflect these data erasures.

Outreach Endpoints

In the table below, you can find which endpoints are used for each type of privacy function. Clicking on the endpoint will take you to the documentation for that endpoint.

Privacy functionEndpoint(s)Description
Access RequestsProspects (opens in a new tab)Used to fetch prospects from Outreach.
Access RequestsRecipients (opens in a new tab)Used to fetch recipients from Outreach.
Delete RequestsProspects, Recipients (opens in a new tab)Used to delete prospects and recipients in Outreach.

By default, deletion requests are fulfilled by masking personal information. To enable Fides to erase personal information instead of just masking it, ensure the masking_strict variable in your fides.toml file is set to false.