# Overview

The LinkedApiAdmin class lets you manage your Linked API subscription status, seats, connected LinkedIn accounts, rate limits and webhook programmatically.

The `LinkedApiAdmin` class lets you manage your Linked API subscription status, seats, connected LinkedIn accounts, rate limits, and webhook programmatically.

## Initialization

Unlike the main SDK, the Admin class requires only your `linkedApiToken` – no `identificationToken` needed:

```typescript
import { LinkedApiAdmin } from '@linkedapi/node';

const admin = new LinkedApiAdmin({
  linkedApiToken: 'your-linked-api-token',
});
```

```python
from linkedapi import LinkedApiAdmin, AdminConfig

admin = LinkedApiAdmin(
    AdminConfig(linked_api_token="your-linked-api-token")
)
```

The class exposes four namespaces matching the [Admin API](/docs/admin-overview) resources:

- `admin.subscription` – manage subscription status and seats
- `admin.accounts` – connect, disconnect, and monitor LinkedIn accounts
- `admin.limits` – configure and monitor rate limits
- `admin.webhooks` – register and inspect your outbound [webhook](/sdks/webhooks)

## Error handling

Admin methods use direct request-response (not workflows), so there is no `execute()` / `result()` pattern. Methods return data directly and throw `LinkedApiError` on failure:

```typescript
try {
  const status = await admin.subscription.getStatus();
  console.log(status.status); // 'active', 'trialing', etc.
} catch (e) {
  if (e instanceof LinkedApiError) {
    console.error(`Error: ${e.type} – ${e.message}`);
  }
}
```

```python
from linkedapi import LinkedApiError

try:
    status = admin.subscription.get_status()
    print(status.status)  # 'active', 'trialing', etc.
except LinkedApiError as e:
    print(f"Error: {e.type} – {e.message}")
```

**Common critical errors:**

- `linkedApiTokenRequired` – missing `linked-api-token`
- `invalidLinkedApiToken` – token is invalid or expired
- `tooManyRequests` – rate limit exceeded (100 requests per 60 seconds)

For the complete HTTP API reference, see the [Admin API docs](/docs/admin-overview).
