--- title: How to add a new Adobe IMS Org in Demo System Next slug: docs/how-to-add-a-new-adobe-ims-org-in-demo-system-next docTags: createdAt: 2024-02-12T21:51:16.055Z --- This page describes, step by step, the process of adding a new Adobe IMS organization in Demo System Next. ### Prerequisites - You need to be the *System Administrator* of your Adobe IMS organization - Your IMS Org needs to be provisioned with all the required AEP applications (RTCDP, AJO, CJA, Target). If your org does not have these products enabled, please submit a Demo Environments & Tool Assists request through [here](https://livedemos.adobe.com/sales-support-request-dashboard). ### Key Steps To add your Adobe IMS Organization in Demo System Next Tools, you will need to perform the following key steps: 1. Create an **AEP Product Profile** and a **Role** with the required permissions 2. Create a new **API Project** in the **Adobe Developer Console** 3. Create a new **IMS Org** in the **Demo System Next Tools** 4. Add **AEP Sandboxes** to your **Environments** list ### Step 1: Create an AEP Product Profile and a Role with the required permissions ::::VerticalSplit{layout="right"} :::VerticalSplitItem 1\. Open the [Adobe Admin Console ](https://adminconsole.adobe.com/)and click on **Products **in the top menu ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/2cJGW9GOu3yyo2v_7ldkQ_cleanshot-2024-02-16-at-174605.png) ::: :::: ::::VerticalSplit{layout="right"} :::VerticalSplitItem 2\. Click on **Adobe Experience Platform** ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/9_xzoHTbkfVDlbfgkXZQu_cleanshot-2024-02-16-at-160155.png) ::: :::: ::::VerticalSplit{layout="right"} :::VerticalSplitItem 3\. Create a new Product Profile `Demo System Next API Access - AEP` by clicking on **New Profile** ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/OPWJqK-cgYC9zJ4GJ7mGa_cleanshot-2024-02-16-at-161923.png) ::: :::: ::::VerticalSplit{layout="right"} :::VerticalSplitItem 4\. Open the [Experience Cloud Home](https://experience.adobe.com/) and click on **Permissions** ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/Fq9IDaWqdFHaeDhLH0uaM_cleanshot-2024-02-16-at-162046.png) ::: :::: ::::VerticalSplit{layout="right"} :::VerticalSplitItem 5\. Click on the **Create role** button and enter the following details: - Name: `Demo System Next API Access - AEP` - Description: `This profile groups all sandboxes that should be accessible by Demo System Next API` ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/616r33oLlJF962bRVN95a_cleanshot-2024-02-16-at-174658.png) ::: :::: ::::VerticalSplit{layout="right"} :::VerticalSplitItem 6\. **Edit** the Role permission and add the `Prod` **+ other sandboxes** that you need to connect to Demo System Next with all required permissions to manage AEP resources through the APIs e.g. *Manage Schemas, Manage Datasets, etc.* **IMPORTANT: **Please add all the permissions on the left hand rail by clicking on all the '+' and select 'Add all' to populate all the values for each permission. Once all the permissions are added, make sure to click 'Save' on the top right corner. ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/sW5YCP9jejMCQLlc2Ac5F_cleanshot-2024-02-16-at-162648.png) ::: :::: You have now configured the AEP Product Profile and the required Role permissions. ### Step 2: Create a new API Project in the Adobe Developer Console ::::VerticalSplit{layout="right"} :::VerticalSplitItem 1\. Open the [Adobe Developer Console ](https://developer.adobe.com/console/projects)project view (make sure you are in the right IMS Org) and click on **Create new project** ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/QLFG0q8AuWTZRYGzGPsAv_cleanshot-2024-02-16-at-163429.png) ::: :::: ::::VerticalSplit{layout="right"} :::VerticalSplitItem 2\. **Edit** the project to set the project Title to: `Demo System Next` ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/OnE_OOAEK01AMhYhNFGZg_cleanshot-2024-02-16-at-163659.png) ::: :::: ::::VerticalSplit{layout="right"} :::VerticalSplitItem 3\. Add the following APIs to the project using the Product Profile `Demo System Next API Access - AEP`: - `Experience Platform API` - `Experience Platform Launch API` - `Adobe Journey Optimizer` - `Privacy Service API` - `Places` - `Assurance API` - `Customer Journey Analytics` For each API, select OAuth Server-to-Server and all the product profiles to enable ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/mWsAWehAjZhxdagV_lARH_cleanshot-2024-02-16-at-164401.png) ::: :::: ::::VerticalSplit{layout="right"} :::VerticalSplitItem 4\. Click on **OAuth Server-to-Server** in the left menu and save the following credential details for later: - `Credential Name` - `Client ID` - `Client Secret` - `Technical Account ID` - `Scopes` ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/bjG-Zi1DPQxqgI1TodUGb_cleanshot-2024-02-16-at-164900.png) ::: :::: 5. Return to your 'Demo System Next API Access - AEP' screen within AEP. You should now add this new `Demo System Next` API Credential to the **AEP Role** > API Credentials: ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/v25tXZicDBYHMmCj-GuQ3_cleanshot-2024-02-16-at-173429.png) Your Developer project is now ready for the Demo System Next integration. ### Step 3: Create a new IMS Org in Demo System Next ::::VerticalSplit{layout="right"} :::VerticalSplitItem 1\. Open [Demo System Next Tools](https://dsn.adobe.com/tools) and click on **IMS Org Admin** ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/12-18W484VVjgOcOZy8Wu_cleanshot-2024-02-16-at-165312.png) ::: :::: ::::VerticalSplit{layout="right"} :::VerticalSplitItem 2\. Click on **Add Org** ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/cFPHrOxAHtrzg9FIImkP3_cleanshot-2024-02-16-at-165416.png) ::: :::: ::::VerticalSplit{layout="right"} :::VerticalSplitItem 3\. Enter the following details and click on the **Save** button: - `IMS Org ID` - `Name` - `Tenant ID` - `Region` ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/gHf5O_241mUkLr_kuL9IK_cleanshot-2024-02-16-at-165553.png) ::: :::: ::::VerticalSplit{layout="right"} :::VerticalSplitItem 4\. Click on the **Actions **button ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/2ymQh0sZ67CpeKXZQSDvp_cleanshot-2024-02-16-at-165840.png) ::: :::: ::::VerticalSplit{layout="right"} :::VerticalSplitItem 5\. Enter the following Credential details copied earlier from the Adobe Developer Console and click on the **Save **button: - `Client ID` - `Client Secret` - `Technical Account ID` - `Scopes` ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/VhbY7feigBEFfzQl-e9ov_cleanshot-2024-02-16-at-170025.png) ::: :::: Your IMS Org has been added to Demo System Next. You can continue in the Environment Admin section to add AEP sandboxes to your [Environments list](https://dsn.adobe.com/environments). ### Step 4: Add AEP Sandboxes to your Environments list ::::VerticalSplit{layout="right"} :::VerticalSplitItem 1\. Go to **[Environments Admin](https://dsn.adobe.com/tools/environment-admin)** using the left menu. Select an IMS Org, select your user then click on **+Assign** **IMPORTANT:** Only one admin can be added per org from the Environments Admin page. If you would like to add multiple admins, please contact our team through [#demo-system-next](https://adobe.enterprise.slack.com/archives/CPCRVPLDQ). ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/0k2ULy7T6t8b4fiHt_MXC_cleanshot-2024-02-16-at-172013.png) ::: :::: ::::VerticalSplit{layout="right"} :::VerticalSplitItem 2\. Enter the AEP Sandbox name and click on the **Confirm **button ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/8yl3eLsHZLSc3F_1V_-vj_cleanshot-2024-02-16-at-172509.png) ::: :::: ::::VerticalSplit{layout="right"} :::VerticalSplitItem 3\. You can now use [DSN Quick Setup ](https://dsn.adobe.com/quick-setup)to deploy a new industry preset configuration on your AEP sandbox ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/rkFKJAbME8rp3cI_2y7bQ_cleanshot-2024-02-16-at-172719.png) ::: :::: Congratulations 🎉, you have successfully onboarded a new Adobe IMS Org in Demo System Next and configured your AEP sandbox with an industry preset using the Quick Setup. *** ### Troubleshooting If you face an issue during the configuration of your AEP sandbox in [Quick Setup](https://dsn.adobe.com/quick-setup), you should verify that the `Demo System Next` API Credential has been added to the AEP Permission API Credentials: ![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/v25tXZicDBYHMmCj-GuQ3_cleanshot-2024-02-16-at-173429.png)