cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 

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:

Overview.png

Whenever you use Sinch services, you are interacting with a resource. Examples of resources are numbersmessagescalls, 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.

 

multiple-cost-center.png

 

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.

multiple-currencies.png

 


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 numbersmessagescalls, 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.

Separate-teams.png

 

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.

 

Dynamic-Projects.png

 

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:

Version history
Last update:
‎03-21-2024 03:35 AM
Updated by: