---
title: "Charity events"
canonical_url: "https://tweetstream.io/docs/charity"
last_updated: 2026-09-24
---

# Charity events

Enable charity alerts in settings and consume live `charity/added` events.

Canonical URL: https://tweetstream.io/docs/charity

## charity/added

Charity events are live-only. Use the envelope `id` to ignore an exact replay.

### Charity added type

```typescript
type CharityAddedEvent = {
  id: string;
  name: string;
  slug: string;
  enabled: boolean;
  taxId?: string;
  location?: {
    city?: string;
    state?: string;
    country?: string;
  };
  observedAt: number;
};
```

### Charity added event

```json
{
  "v": 1,
  "t": "charity",
  "op": "added",
  "id": "4ffccf6e-66d4-555a-af5d-ceb36c10e3f0",
  "ts": 1772000001060,
  "d": {
    "id": "4ffccf6e-66d4-555a-af5d-ceb36c10e3f0",
    "name": "Council on Foreign Relations",
    "slug": "council-on-foreign-relations",
    "enabled": true,
    "taxId": "13-1628168",
    "location": {
      "city": "New York City",
      "state": "NY",
      "country": "US"
    },
    "observedAt": 1772000001060
  }
}
```