# sinch auth

Authenticate with the Sinch API and manage stored credentials.

## sinch auth login

Authenticate with the Sinch API. Prompts for Key ID and Key Secret, verifies them by obtaining an OAuth 2.0 access token, and stores credentials securely (key secrets in OS keychain, session tokens in local config).

You can optionally provide Voice application credentials during login. These are required for `sinch voice` commands but not for functions.

**Syntax**


```sh
sinch auth login [options]
```

**Options**

| Option | Description |
|  --- | --- |
| `-f, --credentials-file <path>` | Load credentials from a JSON file instead of prompting |


**Credentials file format**


```json
{
  "projectId": "your-project-id",
  "keyId": "your-key-id",
  "keySecret": "your-key-secret",
  "applicationKey": "(optional) your-voice-app-key",
  "applicationSecret": "(optional) your-voice-app-secret"
}
```

**Example**


```sh
$ sinch auth login

Sinch API Authentication
Enter your Sinch API credentials (from the Sinch Dashboard)

Project ID (from Sinch Dashboard): abc123de-f456-...
Key ID (from Project > Access Keys): key_live_abcdef
Key Secret: ********

Verifying credentials...
Authentication successful!
```

## sinch auth status

Show the current authentication state: which credentials are stored, whether the OAuth token is valid, and Terms of Service acceptance status.


```sh
sinch auth status
```

## sinch auth logout

Remove all stored credentials (keychain secrets and local session tokens). Prompts for confirmation before clearing.


```sh
sinch auth logout
```