# Configuring the ShotGrid-Bluescape Integration **URL:** \ **Category:** Using Bluescape\ **Tags:** org-admin, integration\ **Created:** [November 3, 2021, 6:47pm UTC](https://community.bluescape.com/t/configuring-the-shotgrid-bluescape-integration/96 "2021-11-03T18:47:57Z")\ **Posts on this page:** 2\ **Page:** 1
**Author:** ![kristeno](https://avatars.discourse-cdn.com/v4/letter/k/c89c15/32.png) [@kristeno](https://community.bluescape.com/u/kristeno)\ **Post date:** [November 3, 2021, 6:47pm UTC](https://community.bluescape.com/t/configuring-the-shotgrid-bluescape-integration/96/1 "2021-11-03T18:47:57Z")
| Support Note | | --- | | This topic is not relevant to all Bluescape members and may not apply to all Teams. If you’re unsure whether your Team has this integration, please reach out to your IT department. | Your workflows in ShotGrid (formerly Shotgun) are now integrated with Bluescape! [ShotGrid](https://knowledge.autodesk.com/support/shotgrid?sort=score) is an Autodesk application for creative project management of film, TV, and games. The integration lets you send ShotGrid versions, assets, playlists, and shots to a Bluescape workspace. The Bluescape integration with ShotGrid must be configured by administrative members of both Bluescape and ShotGrid. If this feature is not visible, contact your IT department. The installation flow is as follows: 1. A Bluescape instance admin must turn on the ShotGrid integration feature. This allows the ShotGrid option to appear on the **Integrations** page of Bluescape Home for the team admin to interact with. 2. The ShotGrid admin must configure the script that manages security controls and allows the Bluescape integration to access ShotGrid APIs. 3. A ShotGrid admin must configure the action menu item that sends ShotGrid content to Bluescape. 4. A Bluescape team admin must enable the integration in Bluescape Home. # Configuring the ShotGrid script The ShotGrid admin must create a new script in ShotGrid. This manages security controls and allows Bluescape to access ShotGrid APIs for the integration. To configure the ShotGrid script: 1. As a ShotGrid admin, select your member avatar in the top-right corner of the screen in ShotGrid. 2. A context menu opens. Select **Scripts** in the **Admin** section. 3. The **Scripts** page opens. Select **Add Script**. 4. The **Create a new Script** window opens. Enter the desired **Script Name**. You will need to provide this to the Bluescape team admin later to enable the integration. Note that the script name is case-sensitive.   5. Enter an optional **Description**. 6. Enter your email address in the **Maintainer email** field. 7. Set the **Permission Group** to the desired permission level. 8. An **Application Key** is automatically generated. Select **Copy to Clipboard** , as you will need to provide this key to the Bluescape team admin. This will provide OAuth authentication for the integration. 9. When finished, select **Create Script**. # Configuring the ShotGrid action menu An action menu is available when you right-click ShotGrid content (such as playlists, assets, versions, and shots). The options in this action menu can be configured by a ShotGrid admin. In this case, the admin must set Bluescape as the endpoint. To configure the right-click action menu item for Bluescape from ShotGrid: 1. As a ShotGrid admin, select your member avatar in the top-right corner of the screen in ShotGrid. 2. A context menu opens. Select **Action Menu Items** in the **Admin** section. 3. The **Action Menu Items** page opens. Select **Add Action Menu**. 4. The **Create a new Action Menu Item** window opens. Type the desired name for the menu item in the **Title** field. We suggest “Send \< ShotGrid entity type \> to Bluescape.” For example: “Send Asset to Bluescape.”   5. Select **Entity Type**. Select the desired ShotGrid entity from the drop-down menu (such as **Asset** , **Version** , **Playlist** , or **Shot** ). Ensure that it matches the entity type in the title you typed above. 6. Enter the URL for the destination where you will send the ShotGrid content in Bluescape. - If you use the standard Bluescape SaaS offering, enter this URL: [https://transfer.apps.us.bluescape.com/api/v3/ami](https://transfer.apps.us.bluescape.com/api/v3/ami). - If you use Bluescape on a Private Instance, contact your IT department and request URLs. For more information, see [Bluescape Architecture](https://community.bluescape.com/t/bluescape-architecture/163). 1. Leave the **Light Payload** checkbox deselected; selecting it causes errors from not sending sufficient data to process the upload. 2. Select **More fields**. 3. Select **Selection Required** from the field list. 4. The **Selection Required** field appears. Ensure the adjacent checkbox is selected. 5. Select **More fields** again. 6. Select **Secret Token** from the field list. 7. The **Secret Token** field appears. Enter your secret token and provide it to the Bluescape team admin. # Enabling the ShotGrid integration in Bluescape Home After an instance admin has turned on the ShotGrid setting, a Bluescape team admin can configure the integration. To configure the ShotGrid integration in Bluescape: 1. As a Bluescape team admin, log into Bluescape and select the Team you want to configure the ShotGrid integration with. Select **Team Settings** and then the **Integrations** tab. 2. You should see the ShotGrid icon. Select :settings: (settings). If you do not see the ShotGrid icon, reply to this topic, and Bluescape Support will assist.   3. The **Enable ShotGrid Integration** window opens. Enter your unique ShotGrid instance URL in the **ShotGrid Instance** field. 4. Enter your **Script Name**. You can receive that value from the ShotGrid admin from step 5 in the instructions to configure the ShotGrid script (see above). 5. Enter the **Application Key**. The ShotGrid admin can provide that to you from the value they copied in step 9 in the instructions to configure the ShotGrid script (see above). 6. Enter the **ShotGrid Version** attribute you want to use to pull ShotGrid content from to push into Bluescape. For example, “sg\_uploaded\_movie” or “sg\_uploaded\_movie\_mp4.” For more information on how to find this value, see below. 7. Enter the **Action Menu Secret Token**. The ShotGrid admin can provide it from step 9 in the instructions to configure the Action Menu item (see above). 8. When you are finished, select **Save**. # Identifying your ShotGrid version attribute To find your **ShotGrid Version** information for the ShotGrid integration: 1. Navigate to the **Assets** page in ShotGrid. 2. Select one of the assets in the list. 3. A list of Versions within the Asset displays. Select **Fields** to add a field to the list. 4. A context menu opens. Scroll down and select **Uploaded Movie**.   5. Scroll over to the new **Uploaded Movie** column and hover your mouse over the **i** (information). 6. A text box appears with the ShotGrid Version value displayed at the top. In the example below, it is sg\_uploaded\_movie.   This is the value that the Bluescape team owner or admin will enter into the **ShotGrid Version** field in the Bluescape Home when enabling the integration. If you have any questions or need assistance from our team, **reply** below. 🙂 * * * **[You’re ready to open your workspace and try ShotGrid! :bluescape_home:](https://my.bluescape.com)** ---
**Author:** ![Antti2000](https://avatars.discourse-cdn.com/v4/letter/a/76d3ee/32.png) [@Antti2000](https://community.bluescape.com/u/Antti2000)\ **Post date:** [January 9, 2025, 10:33pm UTC](https://community.bluescape.com/t/configuring-the-shotgrid-bluescape-integration/96/2 "2025-01-09T22:33:17Z")
Note, that there is now a new option when configuring the Action Menu Item in Shotgrid: **Signature Algorithm** Bluescape only supports _SHA1 (Legacy)_ for this, so make sure to choose that when setting up your Shotgrid integration with Bluescape. ![image](https://us1.discourse-cdn.com/bluescape/original/2X/0/03b0c0aaa65f46d49528a0c90ba196470156fdf4.png)