Configure Blackbaud Luminate Online Integration

Getting Started

To begin setting up the Blackbaud Luminate Online integration, please reach out to your Tatango Customer Success Manager or contact support@tatango.com.

Our team will guide you through the setup process, confirm required configuration details, and work with you to ensure the integration is configured correctly for your organization.

Overview

The Blackbaud Luminate Online integration allows Tatango to sync constituent data from Luminate Online into Tatango so you can send targeted, compliant SMS messages to your supporters.

The integration works by syncing members of specific Luminate Online Groups into Tatango. Any constituent included in a synced group is assumed to be eligible to receive SMS messages based on your organization’s opt-in practices.

What’s Required to Configure the Integration

To get started, Tatango’s Customer Success team will request the following information from your organization.

1. Constituent Fields to Sync

Provide a list of constituent-level fields you would like synced from Luminate Online into Tatango.

Required fields

mobile_phone
home_phone
cons_id

Optional fields (examples)

First Name
Last Name
Zip Code
Last Donation Amount
Custom booleans
Custom text fields

Important:

The list of fields must use the internal field names from Luminate Online, not the display labels shown in the UI.

Example

Display label: First Name
Internal field name: first_name

These internal field names are used directly when fetching data from the Luminate Online API.

2. SMS Opt-Out Custom Boolean

Create a custom boolean field in Luminate Online that represents an SMS opt-out.

Please provide:

The internal field name (for example: custom_boolean12)
The value that should be set when a subscriber opts out of SMS messaging

Tatango will automatically update this field when a subscriber opts out.

3. SMS Cleaned Custom Boolean

Create a custom boolean field in Luminate Online that represents a cleaned phone number (for example, invalid or undeliverable numbers).

Please provide:

The internal field name (for example: custom_boolean13)
The value that should be set when a phone number is cleaned

Tatango will automatically update this field when a phone number is cleaned.

4. Tatango API User Credentials

Create a dedicated Tatango API user in Luminate Online and provide the following details:

Host URL
Example: https://secure.myorganization.com
(Used to access the Luminate Online API)
Login Name
Login Password
API Key
Example Group ID (used for validation and testing)

Helpful documentation for API key setup:

https://docs.blackbaud.com/lo-api/loapi/getting-started/reference/configuration/configureapikeys

5. IP Address Whitelisting

Once the API user is created, whitelist the following IP ranges in Luminate Online to allow Tatango to access the API:

52.40.200.248/24
52.39.10.61/24
52.26.59.155/24

Helpful documentation for API access configuration:

https://docs.blackbaud.com/lo-api/loapi/getting-started/reference/configuration/configureapitoallowserveraccess

6. Tatango Custom Fields

Create custom fields to map the data you are syncing from Luminate Online to Tatango within each list you will use the LO Groups integration:

Navigate to your list
Click Settings -> Custom Fields

Merge Tag Requirement

The Constituent ID field in Tatango must use the merge tag lo_constituent_id. This merge tag is required for the Luminate Online integration to function correctly.

What Data Is Supported

Any constituent-level field available in Luminate Online can be synced to Tatango
Custom fields (booleans and text) are supported
Data is synced only for members of selected Luminate Online Groups

Phone Number Handling

Tatango will attempt to use the mobile phone number first. If no mobile phone number is present, Tatango will fall back to the home phone number.

Important:

When configuring groups, ensure that only constituents who should receive SMS messages are included. The integration assumes that all group members are eligible and properly opted in according to your organization’s compliance practices.

How Often Data Syncs

For users on the lasted version: Syncs are run on demand
Previous versions: Syncs run hourly or daily, depending on your organization's size
Sync time depends on group size:
- Smaller groups may complete in approximately 5 minutes
- Larger groups can take up to 1 hour per group

Data Sent Back to Luminate Online

Tatango updates Luminate Online automatically when key subscriber events occur:

SMS Opt-Outs
The designated SMS Opt-Out custom boolean is updated when a subscriber opts out of text messaging.
Phone Number Cleaning
The designated SMS Cleaned custom boolean is updated when a phone number is cleaned.

How to Configure the Integration

Once Tatango Customer Success has gathered all required setup information, you can configure the Blackbaud Luminate Online integration directly within Tatango.

Step 1: Navigate to the Integration

Log in to Tatango
Navigate to My Account → Integrations → Custom Apps
Locate the Blackbaud Luminate Online integration tile
Click Configure

Step 2: Enter Blackbaud Authentication Credentials

You will be prompted to provide your Luminate Online API credentials:

API Key
Login Name
Login Password
Host URL
Example: https://secure.myorganization.com

These credentials are used to authenticate requests to the Luminate Online API.

Step 3: Select a List for Data Mapping

Next, select the Tatango list you would like to use for data mapping.

Important notes about lists:

The integration can be used across any Tatango list
To ensure compatibility across lists, custom fields must use consistent merge tag values
This is especially important if you plan to reuse the integration for multiple lists

Required merge tag