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 Build Dashboard, or by contacting your Sinch Account Manager.
When you sign up to the Sinch 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 Build 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 |
Automatically |
||
|
Purpose |
Unique ID for Sinch customer |
Separate access/usage/billing |
Separate access/usage |
Control balance/invoice/currency. |
|
API key |
None |
None |
None |
*Except customers signed through ASPs
Get started by creating a Sinch Account in the Sinch Build Dashboard.
