Sinch Community

Accounts   Your Sinch account is created when you sign up in the Sinch Customer Dashboard. It represents the relationship between your business and Sinch and ties together all your Sinch services.   The account resource forms the root of the resource hierarchy that relates to your business. In short, a Sinch account:   Represents your relationship with Sinch Is the root of your resource hierarchy.   Billing Accounts   When you use Sinch services, you will be incurring charges to a billing account. Billing accounts maintain your account balance and contain your payment information such as name, address, currency type, and tax ID.   A Sinch account may have multiple billing account resources to control how the usage of Sinch services gets billed. This is done by linking the billing account to the projects you want it to pay for. Reach out to your Sinch Account Manager if you need help setting this up.   Billing accounts exist in two flavors: prepaid and postpaid.   Prepaid billing accounts maintain an account balance that you can easily top up using your preferred billing method. Postpaid billing accounts are paid via invoice.   In short, a billing account:   Collects charges for all different Sinch products and maintains your account balance Controls how other resources are billed Stores payment information such as name, address, currency type, and tax ID for your business.   Learn more about how the Sinch account model works. ... View more

No. Subprojects are tied to parent projects. Each parent project connects back to the billing information on your Sinch account.   Learn more about the Sinch account model.  ... View more

Not for subprojects. With subprojects being tied to a project (a.k.a. parent project), that means the project determines billing.   Though, you can have separate billing accounts for projects. Contact your account manager  to get multiple billing accounts for projects. ... View more

Subprojects are a great way to keep ASP business relationships organized.   One project can have many subprojects, each with a separately tracked ID. Once a project has subprojects under it, it becomes known as a parent project. The parent project will handle payment for all subprojects, yet each subproject will have its own unique set of data tied back to your customer.     You can create a new subproject for each customer. And should they leave, it’s as easy as deleting the subproject!   Follow our Subprojects API getting started documentation to start organizing today. ... View more

Not at this time. A subproject can only be tied to one parent project.   Related Articles: What is a subproject and how to manage subprojects? What is a project and managing projects? Creating a new project Sinch Account Model. ... View more

With projects and subprojects!   Let’s say you have three departments that use a collection of Sinch products: The marketing team uses Conversation API, your customer service team uses Voice API, and you send meeting reminders internally and externally with the SMS REST API.   To keep the activity of each department separate, keep each in their own Sinch project.   Projects can be created on the Sinch Customer Dashboard. Learn how here.   Let’s also say you sell Sinch products as an ASP through your customer service team. Perhaps under your customer service project, you might choose to create subprojects. With each subproject having its own ID, display name, and completely customizable labels (for metadata), the Subprojects API is flexible in suiting to your business needs.     Learn more about how the Sinch account model works. ... View more

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:   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. 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. 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?. ... View more

The Sinch account model provides you with the necessary tools to consume Sinch services and to manage concerns such as access control and billing.   The Sinch account model is composed of the following four elements: Accounts Billing accounts Projects Subprojects. You can customize your account structure using our APIs, the Sinch Customer Dashboard, or by contacting your Sinch Account Manager.    When you sign up to the Sinch Customer Dashboard, a Sinch account and a billing account are automatically created for you. Generally, a Sinch account will not need any adjustments while the billing account may need to be updated with invoicing or credit card information.  A project is necessary to use any Sinch product available through the dashboard. Your first project is also created automatically upon account creation. Subprojects are optional.   Here’s a summary of how it all works: Whenever you use Sinch services, you are interacting with a resource. Examples of resources are numbers, messages, calls, emails and conversations. These resources are either exposed directly through one of our REST APIs or indirectly through one of our applications.   The Sinch account model introduces additional organizational resources such as accounts, billing accounts, projects, and subprojects. These resources may relate to other resources, and together they form a resource hierarchy. The resource hierarchy can be used to mirror your organization's structure to control access to different groups of resources.   We will now dive into how each element works.   Sinch accounts Your Sinch account is created when you sign up on the Sinch Customer Dashboard. A Sinch account: Represents the relationship between your business and Sinch and ties together all your Sinch services. forms the root of the resource hierarchy that relates to your business.   Billing accounts When you use Sinch services, you will be incurring charges to a billing account. Billing accounts maintain your account balance and contain your payment information such as name, address, currency type, and tax ID.   A Sinch account may have multiple billing account resources to control how the usage of Sinch services gets billed by linking the billing account to the projects you want it to pay for.   Billing accounts exist in two flavors: Prepaid billing accounts maintain an account balance that you can easily top up using your preferred billing method. Postpaid billing accounts are paid by invoice.   Example: multiple cost centers Big Business is a large enterprise with many different departments, of which several are using Sinch services. They want each of these departments to get invoiced separately and can achieve this by creating one billing account per department.     Example: multiple currencies Dough Generator is an international company that uses Sinch services in multiple different regions. They can pay in the respective local currencies by creating one billing account per region.   Projects  To use the products that Sinch offers, you first need a project. Projects group resources together to simplify access control and billing. When creating resources associated with one of Sinch's products (such as numbers, messages, calls, and conversations), they are created within the context of a containing project.   A Sinch account may have multiple project resources, typically one per application, environment, or team that is using Sinch services.   Example: separate teams Crunch Time is a company with a portfolio of products that use Sinch services. Each product is built by a separate team of developers that want to restrict access to their service configuration. This is achieved by creating a project for each team and inviting the respective team members to that project.   Subprojects Subprojects are like projects in the sense that they are also a way to group resources together dynamically. In fact, they are projects, but with some important distinctions: they always belong to a parent project and they do not affect billing instead relying on their parent project for billing purposes.   A project may have multiple subproject resources that can be used when there is need for more levels in the resource hierarchy to organize your resources. They can also be used to create new groups of resources easily and dynamically.   Example: dynamic projects Middleman Brokering is a company which uses Sinch services as part of its platform. They have hundreds of clients and are actively adding new ones every day. They want to track how much each of their clients indirectly uses Sinch services. They do this by creating a subproject for each client. They can automate this process since there is no need to configure billing manually for any of the clients.     Summary In summary, the Sinch account model is designed to give you the tools needed to better organize your products, teams, and projects.:     Account Project Subproject Billing Account Usage One per Sinch customer* One or more per account zero or more per project One or more per account Who is it for Any Sinch customer* Any Sinch customer* Primarily ASPs Any Sinch customer* How to create Automatically Customer Dashboard Customer Dashboard Automatically Purpose Unique ID for Sinch customer Separate access/usage/billing Separate access/usage Control balance/invoice/currency. API key None Customer Dashboard None None *Except customers signed through ASPs   Get started by creating a Sinch Account in the Sinch Customer Dashboard.    Related Articles: What is a project and managing projects? Creating a new project What is a project ID? What is a subproject? ... View more

To create a resource associated with one of Sinch's products, a project is required to hold it.    When you create an account on the SInch Customer Dashboard, your first project is automatically assigned to your account. To identify the project, it is also given a unique alphanumeric identifier that ties it to your account. Sinch projects are the primary way to group resources together to simplify management, access to, and billing of your resources.   Projects can be used to obtain access separation such that application workloads may have access to some projects but not to other projects.  This is achieved by creating a unique API key per project. A Sinch account may own multiple projects, typically one per customer application, environment or team that is using Sinch services. Projects can have subprojects.   Where can I find my project ID? Log in to the Sinch Customer Dashboard. You can easily access all your projects from theProject top menu. Click the Project menu at the top left of the screen:   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. Your current project is highlighted (in yellow and with a tick mark).   To view details of a project select the project you are interested in and click the options icon (three vertical dots)  to the right of the project name. The details of your project are displayed:   The Project ID is displayed at the top of the details list and you can click the copy icon to copy it to your clipboard.   Related Articles Sinch Account Model What is a subproject? What is a project and managing projects? ... View more