# Subscribers

URL: /docs/developers/collect/subscribers

Subscribers are customers who follow your project on Orvelt. Invite customers who already know you, such as a mailing list or recent buyers who agreed to hear from you, and watch the count grow.

## Invite customers [#invite-customers]

### `subscribers.invite` [#subscribersinvite]

**TypeScript SDK**

```ts
import { subscribers } from '@orvelt/business';

const result = await subscribers.invite({
  projectId: 'PROJECT_ID',
  subscribers: [{ name: 'Alex', email: 'alex@example.com' }],
});
if (result.error) throw new Error(result.error.message);

const { invited, skipped, invitationAllowance } = result.data;
console.log(`${invited.length} invited, ${skipped.length} skipped`);
console.log(`${invitationAllowance.remaining} invitations left today`);
```

**Python SDK**

```python
import os
from orvelt_business import Orvelt

with Orvelt(business_api_key=os.environ["ORVELT_BUSINESS_API_KEY"]) as client:
    result = client.subscribers.invite(
        project_id="PROJECT_ID",
        subscribers=[{"name": "Alex", "email": "alex@example.com"}],
    )
    print(f"{len(result.invited)} invited, {len(result.skipped)} skipped")
    print(f"{result.invitation_allowance.remaining} invitations left today")
```

Send 1–100 people per call, each with a name (1–120 characters) and an email (up to 320 characters, trimmed and lowercased). A project can send 100 invitations a day; `invitationAllowance` reports `used`, `limit`, `remaining`, and `resetsAt`. Duplicates and people already invited or subscribed are returned in `skipped` with a reason. An invitation is not a subscription: people become subscribers when they accept.

Inviting needs `subscribers` invite. New API keys include it, but older read-only keys do not, and `subscribers` read never grants it.

## Track growth [#track-growth]

### `subscribers.count` [#subscriberscount]

**TypeScript SDK**

```ts
import { subscribers } from '@orvelt/business';

const result = await subscribers.count({ projectId: 'PROJECT_ID' });
if (result.error) throw new Error(result.error.message);
console.log(result.data.total, result.data.delta);
```

**Python SDK**

```python
import os
from orvelt_business import Orvelt

with Orvelt(business_api_key=os.environ["ORVELT_BUSINESS_API_KEY"]) as client:
    result = client.subscribers.count(project_id="PROJECT_ID")
    print(result.total, result.delta)
```

`total` is today's subscriber count, and `delta` is the change between the last 30 days and the 30 days before, ready for a dashboard tile.

## Find a subscriber [#find-a-subscriber]

### Search the list [#search-the-list]

Look someone up by email or name with the REST-only [list operation](/docs/api-reference/endpoints/project-subscribers/project.subscribers.list) and a `query`, following [pagination](/docs/developers/pagination) for the full list. Show subscriber details only to people who need them: this is customer data, not a public feed.