What is a subproject and how to manage subprojects?

[Michelle_Peruskie]

Subprojects always belong to a parent project and are like projects in the sense that they are also a way to group resources together dynamically. However, they differ from projects as they do not affect billing instead relying on their parent project for billing purposes. Subprojects cannot have other subprojects attached - only parent projects (a.k.a. projects) can have subprojects.

A great example of how subprojects can be useful is when acting as an application service provider (ASP) for Sinch Products. The ASP can create a subproject for each new customer and simply remove the subproject if the customer leaves. Usage for each customer is measured separately. 

Accessing and managing Subprojects

You can access subprojects from the Projects top menu or from the Projects page in the Sinch customer dashbaord:

1. Log in to the Sinch Customer Dashboard. Click the Projects menu in the top bar:
   
   
   
   A list of your projects is displayed. If you have multiple projects then you can search for your project or the project ID in the search field at the top of the project list.
   
   
2. Your current project is highlighted (in yellow and with a tick mark). If you click the options icon (three vertical dots)  to the right of the current project name, you can see the details for the selected project. Click Subprojects.
   
   
3. The Subprojects page is displayed:
   
   
   
   This page shows you a list of your subprojects (for the selected project) along with the Project ID and the date the subproject was created. 
   
   

Creating subprojects

To create a new subproject click CREATE SUBPROJECT. The Create subproject dialog is displayed:



Enter a name for your new subproject in the Name field. Click CREATE. The new subproject is created and displayed at the top of the list on the Subprojects page:



Note: After creating a new subproject, you must create a corresponding Service API if you want to send SMS messages using that subproject.

Viewing subproject details

To view the details for a subproject click the options icon (three vertical dots highlight in red above)  to the right of the current project name. The subproject details are displayed:

The project details panel contains the following information and options:

Name	Displays the subproject name in the format: {Parent Project Name} > {Subproject Name}
Project ID	Displays the Project ID. To copy the Project ID to your clipboard, click the copy icon.
General Settings	Configure the subproject settings including changing the subproject name.
Access keys	Shows you the access keys for your selected subproject. A unique API key can be generated for each subproject in the customer dashboard, but it is also possible to use the key of the parent project to access subproject resources. Learn more about access keys and how Sinch uses them.

Related Articles:

• What is a project and how to manage projects?
• Sinch Account Model

• What is a project ID?.

[#2]

Following a successful early release for selected customers, on 3 June 2024 Sinch will continue to roll out a new single sign-on login experience that will allow you to seamlessly login to any existing Sinch services that you may use. The best part is that your existing login credentials (for Sinch Dashboard or Mailgun Control panel) will be migrated across to create your new Sinch ID.

What is Sinch ID?

Your Sinch ID is a single user identity for all Sinch products and services. With Sinch ID, you can use one set of login credentials and two-factor authentication (2FA) to login to multiple dashboards within our communications ecosystem. We are starting with the Sinch Dashboard and the Mailgun Control Panel, where using the Sinch ID you can now use the same credentials to access both platforms. 

Your Sinch ID will be managed in its own application (https://id.sinch.com), where you can:

•        Enroll in 2FA (SMS or App)
•        Obtain recovery codes
•        Change your password.

How does this impact me?

Important: This change will not affect all users and is being rolled out in a phased manner. 

As an existing customer, you do not have to do anything – your existing email/password and 2FA will be automatically migrated to a Sinch ID.

You will however, notice a different sequence of login pages when you try to log in. But don’t worry, we will guide you step-by-step through the new experience below. 

The New Login Experience!

The new login experience is straightforward – we will walk you through the steps below:

1. Login to the Sinch Customer Dashboard:
   
   
   
   Please enter your email address as normal. Click CONTINUE.
   
2. Your email address will be verified:
   
   
   
   Enter your existing password. It's the same one you've been using to login to the Sinch Dashboard. In other words, although the login experience is a bit different now, your login password has not changed.
   
   Click Continue.
   
   
3. The Verify your identity dialog is displayed:
   
   
   
   Sinch uses Two Factor Authentication (2FA) for added security. A text message will be sent to your verified phone number screen containing your 2FA token code.
   
   Enter the 6-digit token and click Continue.
   
   
4. The first time you log using the new SInch ID, your recovery code is displayed:
   
   
   
   Your recovery code is important as it allows you to verify your account if you lose your 2FA credentials or your 2FA phone. Please copy your recovery code and store it somewhere safe.
   
   Click the check box to confirm you have copied the code and click Continue.
   
   Note: The recovery code is only displayed the first time you log into the Sinch Dashboard using the new SInch ID.
   
   
5. You'll now be logged in and taken to the Sinch Dashboard Welcome page. 

Got Questions?

If you have any questions or concerns, please raise a ticket with the Sinch Support team who will be able happy to assist you!