Skip to main content

Connecting Luminate Online

Updated

Sync constituents, donations, campaigns, and email data from Luminate Online to Avid for analysis, segmentation, and marketing automation.

Use this article when

  • You want to connect your Luminate Online instance to Avid for the first time.
  • You need to find your Web Service URL in Luminate Online.
  • You are updating an existing Luminate Online connection with new credentials.
  • You need to configure API permissions or whitelist IP addresses.

Before you begin

Requirement Details
Avid permission Connections > Edit
Luminate Online role API Administrator with Use Luminate Online APIs permission
What Avid syncs Constituents, donations, campaigns, donation forms, email campaigns, email messages, email recipients, group types, groups, interests (read-only)
Time estimate 10–15 minutes

Avid only reads data from Luminate Online — it never writes, modifies, or deletes records. You must whitelist Avid's IP addresses in your Luminate Online account before connecting.

Step 1: Prepare your Luminate Online account

Before connecting Avid, whitelist Avid's IP addresses and verify your API account has the required permissions.

Whitelist Avid's IP addresses

Luminate Online requires IP whitelisting. Add these three IP addresses to your account's firewall settings:

  • 35.184.153.118/32
  • 35.238.235.148/32
  • 35.225.16.95/32

Connections will fail if these IPs are not whitelisted. Contact your Luminate Online administrator if you do not have access to firewall settings.

Verify API account permissions

The account you use to connect must have these settings:

  1. Log in to Luminate Online as an administrator.
  2. Navigate to the user account that will authenticate with Avid.
  3. Verify the account has:
    • Administrator status (active constituent with admin role)
    • Membership in an admin security group
    • The Use Luminate Online APIs permission enabled

Create a dedicated API account for Avid rather than using a personal admin account. This makes it easier to manage access and audit API activity.

Step 2: Find your Web Service URL

Your Web Service URL is the base endpoint for Luminate Online's SOAP API.

  1. Log in to Luminate Online as an administrator.

  2. Navigate to Administration > System > Web Services.

    You see your organization's Web Service URL.

  3. Copy the URL. It should look like:

    https://webservices.cluster2.convio.net/1.0/org_name

    Replace cluster2 with your cluster number and org_name with your organization's name.

Your exact cluster number and organization name are shown in the Luminate Online Web Services settings. If you do not see this page, contact Luminate Online support to enable API access.

Step 3: Connect Luminate Online to Avid

  1. In Avid, go to Connections.
  2. Click Add Connection.

  3. Search for and select Luminate Online.

    The connection form opens.

  4. Enter your credentials:
    • Web Service URL — Paste the URL you copied in Step 2 (for example, https://webservices.cluster2.convio.net/1.0/org_name)
    • Luminate Online Username — The username of your API Administrator account
    • Luminate Online Password — The password for your API Administrator account

  5. Click Save.

    Avid validates the credentials by calling the Luminate Online SOAP API. This may take a few seconds.

If successful, the Luminate Online connection appears in your connections list with a Connected status.

What you'll see

After a successful connection, Avid begins syncing the following data from Luminate Online within a few minutes:

  • Constituents — Donor and constituent records
  • Donations — Donation and transaction history
  • Donation Campaigns — Campaign tracking and attribution
  • Donation Forms — Online donation form metadata
  • Email Campaigns — Email campaign records
  • Email Messages — Email message metadata and delivery status
  • Email Recipients — Email recipient activity and engagement
  • Groups — Constituent groups and lists
  • Group Types — Group classification metadata
  • Interests — Constituent interests and preferences

Your Luminate Online data appears as Data Sets in Avid. You can build audiences, review reports in Insights, and push audiences to marketing platforms via Pathways.

Avid syncs data continuously from Luminate Online in one direction only. Avid never writes or modifies records in your Luminate Online instance. 

Troubleshooting

Connection fails with "Integration failed"
  1. Verify the Web Service URL is correct. Copy it directly from Luminate Online without extra spaces or characters.
  2. Confirm the URL follows the format: https://webservices.cluster2.convio.net/1.0/org_name with two path segments (/1.0 and /org_name).
  3. Verify the IP addresses are whitelisted. Contact your Luminate Online administrator to confirm all three IPs are added to your firewall settings.
  4. Check your Luminate Online account status. If your subscription is inactive, the API may be disabled.
Connection fails with "unable to query the Luminate Online API"
  1. Verify the username is correct. Copy it directly from Luminate Online without extra spaces.
  2. Verify the password is correct. Passwords are case-sensitive.
  3. Confirm the account has API Administrator status. Log in to Luminate Online and check the user's role under Administration > Users.
  4. Confirm the account's security group has the Use Luminate Online APIs permission enabled.
  5. Try logging in to Luminate Online directly with these credentials to rule out account issues.
  6. Contact Luminate Online support if the account has the correct permissions but still cannot authenticate.
Data is not syncing after connection
  1. The initial sync can take 10–30 minutes depending on data volume. Check back in a few minutes.
  2. Check the sync status in Avid. Go to Connections and click your Luminate Online connection to check for errors.
  3. Verify data exists in Luminate Online. Log in and confirm you have constituents, donations, and other records.
  4. If syncs continue to fail, submit a request with the connection name so we can investigate.
Sync fails intermittently with session errors

Luminate Online limits concurrent SOAP sessions. If you see sync errors mentioning "active synchronization session":

  1. This typically resolves on its own. Avid automatically retries after waiting a brief period.
  2. If retries continue to fail, contact your Luminate Online administrator to check for other active API sessions that may be locking the sync session.
  3. Avoid running other API-based integrations or reports simultaneously with Avid syncs. Stagger them by 30+ minutes.
Updating credentials on an existing connection
  1. In Avid, go to Connections and find your Luminate Online connection.
  2. Click Edit.
  3. Update the Web Service URL, username, or password as needed.

  4. Click Save.

    Avid validates the new credentials immediately.

Related to

Related articles