Accounts & projects

Sinch Agentic Tools

Sinch SDKs

Sinch CLI & Functions

Sinch organizes everything you build into a simple hierarchy. Your account contains one or more projects, and each project contains the resources your applications use, such as numbers, apps, and access keys.

Note:

Where a resource lives tells you which credentials it needs. Most of the Sinch APIs are scoped to a project, so the project ID is part of the request URL.

The hierarchy at a glance

Account                      ← your organization; what you're billed as
└── Project                  ← a workspace that groups related resources
    ├── Access keys          ← Key ID + Key Secret used to authenticate
    ├── Numbers              ← phone numbers you've provisioned
    ├── Apps                 ← Voice / Verification application credentials
    └── Other resources      ← campaigns, conversations, senders, etc.

Account

Your account is the top of the hierarchy. It represents your organization to Sinch, and it's what you're billed against. An account can contain many projects and many team members, who each sign in to the Sinch Build Dashboard with their own individual Sinch ID.

Project

A project is a workspace inside your account that groups related resources. Use separate projects to keep environments or workloads apart. For example, you might create a production project and a staging project, or one project per application.

Each project has a unique Project ID. For the Sinch APIs, this ID is part of the request path:

https://numbers.api.sinch.com/v1/projects/YOUR_project_id/availableNumbers

Placeholder	Description
YOUR_project_id	The ID of the project that owns the resource. Find it in the dashboard under Settings → Projects.

Resources

Resources are the things you create and use: provisioned numbers, Voice and Verification apps, SMS senders, access keys, and so on. Most resources belong to a single project and can't be shared across projects. If you need the same setup in two environments, create it in each project.

Find your IDs in the dashboard

Sign in to the Sinch Build Dashboard.
Use the project menu in the top-left of the dashboard to select a project.
Open Settings → Projects to view its Project ID.
Your Account ID is shown in your account settings.

Important!

You'll need this later! Keep your Project ID handy. You'll paste it into almost every Sinch API request and into your OAuth2 token calls.

Create a new project (enabled accounts only)

In the dashboard, open the project switcher (top-right).
Select Create project (or New project).
Give the project a name that reflects its purpose (e.g. acme-production).
Create access keys inside the new project to start making API calls scoped to it.

Note:

Access keys are scoped to the project they're created in. A key from your staging project can't act on production resources, so create a separate key for each project.

Continue to Authentication methods to pick the right path for your product.