---
title: "Considerations for Sandboxes"
slug: "considerations-for-sandboxes"
tags: ["Events"]
updated: 2026-02-04T21:02:42Z
published: 2026-02-04T21:02:42Z
canonical: "docs.blackthorn.io/considerations-for-sandboxes"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blackthorn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Considerations for Sandboxes

After refreshing a full or partial sandbox, you must perform the following steps to complete the process.

- [Clear the **Event Page URL** field.](/v1/docs/considerations-for-sandboxes#clear-the-event-page-url-field)
- [Update the Events_Domain remote site.](/v1/docs/considerations-for-sandboxes#update-the-events_domain-remote-site)
- [Update the **Platform Domain** field.](/v1/docs/considerations-for-sandboxes#update-the-platform-domain-field)
- [Reauthorize DocumentLink.](/v1/docs/considerations-for-sandboxes#reauthorize-documentlink)
- [Install and reauthorize the Blackthorn Connected App(s).](/v1/docs/considerations-for-sandboxes#install-and-reauthorize-the-blackthorn-connected-apps)

## Clear the Event Page URL Field

When you refresh a full or partial sandbox, you can include Blackthorn objects in your refresh template. If you include the Blackthorn Events objects, it copies the **Event Page URL** field from production. The field's value won't be updated automatically for the sandbox and related Org ID. Please make sure to use the **Event URL** field.

You can also manually clear the **Event Page URL** field using one of the following methods. This will generate the correct **Event URL**.

- Go to the individual Event record for a one-off update.
- Use a list view to mass-update Events.
- Use a dataloader to make changes to multiple Events.

## Update the Events_Domain Remote Site

1. Go to Setup.
2. In the Quick Find box, enter and click “Remote Site Settings.”
3. Click **Edit** next to Events_Domain.
4. Enter “https://events.blackthorn.io” in the **Remote Site URL** field.
5. Click **Save**.

## Update the Platform Domain Field

1. Go to Setup.
2. In the Quick Find box, enter and click “Custom Settings.”
3. Click **Manage** next to Blackthorn | Events Settings.
4. Click **Edit**.
5. Update the **Platform Domain** field to match the **Remote Site URL** field.
6. Click **Save**.

## Reauthorize DocumentLink

After refreshing your sandbox, you must reauthorize DocumentLink to avoid errors.

1. Click the [oauth link](https://auth.blackthorn.io/salesforce?packages=03361000000DksxAAC&environment=sandbox) to complete the DocumentLink setup.
2. Click **Allow** to allow access.

![K_03_auth doclink pic 1](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/K_03_auth%20doclink%20pic%201.png)
3. If the authorization is successful, you will see a success message.

![K_03_auth doclink pic 2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/K_03_auth%20doclink%20pic%202.png)

## Install and Reauthorize the Blackthorn Connected App(s)

The following Connected Apps must be installed and reauthorized in your Salesforce orgs.

- Blackthorn | Connected App - required for using Blackthorn Events and Blackthorn Payments
- Mobile Check-in - required to use the Blackthorn Mobile Check-in app
- Blackthorn | Mobile Connected App - required to use the Blackthorn Mobile Payments app
- Blackthorn Message - required for using Blackthorn Messaging

For each org that you use to log in to Blackthorn, have a Salesforce System Administrator in complete the following steps.

1. Go to Setup.
2. In the Quick Find box, enter and click "Connected Apps OAuth Usage." ![Connected Apps Oauth](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/image-1770238821017.png)
3. Find the following Blackthorn apps:
  - Blackthorn | Connected App - for all users (Events and Payments)
  - Mobile Check-in App - if the Mobile Check-in is being used
  - Blackthorn | Mobile Connected App - if the Mobile Payments is being used
  - Blackthorn Message - if Messaging is being used
4. Click **Install** for each of the apps. *Note:* If the **Uninstall** button appears instead of the **Install** button, the app has already been installed, and you do not need to do anything. ![Salesforce Connected Apps_Install](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Salesforce%20Connected%20Apps_Install.png)
5. Once installed, check the app’s settings and make sure your policy has Permitted Users set to “All users may self-authorize.” ![Connected Apps_Confirm Permitted Users](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Connected%20Apps_Confirm%20Permitted%20Users.png)

Once all of the apps are installed, they will appear in the “Managed Connected Apps” and “Connected Apps OAuth Usage” sections.