> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Notifications API

> Notification, bir kullanıcıya iletilen yeni bir gönderi, bir ödeme veya bir bahsetme gibi bir mesajdır.

Her biri, kullanıcının ait olduğu bir deneyimden veya içinde bulunduğu bir ekipten gelir ve kullanıcıların tercih belirlediği, yeni satışlar gibi bir konu altında yer alır.

Bir kullanıcının akışını listelemek, okunmamış rozetlerini okumak ve temizlemek, uygulamanızdan bir deneyimin kullanıcılarına veya bir hesabın ekibine bildirim göndermek ve bildirim tercihlerinin başvurduğu konu kataloğunu listelemek için Notifications API'yi kullanın.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [List Notifications](https://docs.whop.com/tr/api-reference/notifications/list-notifications.md) | GET `/notifications` |
| [Retrieve Notification](https://docs.whop.com/tr/api-reference/notifications/retrieve-notification.md) | GET `/notifications/{id}` |
| [List Notification Badges](https://docs.whop.com/tr/api-reference/notifications/list-notification-badges.md) | GET `/notifications/badges` |
| [List Notification Topics](https://docs.whop.com/tr/api-reference/notifications/list-notification-topics.md) | GET `/notifications/topics` |
| [Send Notification](https://docs.whop.com/tr/api-reference/notifications/send-notification.md) | POST `/notifications` |
| [Mark Notifications Read](https://docs.whop.com/tr/api-reference/notifications/mark-notifications-read.md) | POST `/notifications/mark_read` |

## Özellikler

**id** `string` *required*

Bildirim kimliği. Akış satırları, liste imleci görevi de gören birleşik bir kimlik taşır.

**account** `object | null` *required*

Bildirimin ait olduğu hesap. Bildirim bir hesapla ilişkili olmadığında `null`.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `biz_` önekli hesap kimliği.
>
> **logo\_url** `string | null` *required*
>
> Hesap logosu görsel URL'si. Hesap bir logo yüklemediğinde `null`.
>
> **route** `string | null` *required*
>
> Hesabın whop.com üzerindeki mağaza sayfasının URL kısa adı.
>
> **title** `string` *required*
>
> Hesabın görünen adı.

**attachment\_url** `string` *required*

Bildirimin yanında gösterilen görsel — gönderenin avatarı veya varsayılan bildirim görseli.

**content** `string` *required*

Kullanıcıya gösterilen bildirimin gövde metni.

**created\_at** `string` *required*

Bildirimin oluşturulma zamanı, ISO 8601 zaman damgası olarak.

**experience** `object | null` *required*

Bildirimin ilişkili olduğu deneyim. Belirli bir deneyime bağlı olmadığında `null`.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `exp_` önekli deneyim kimliği.
>
> **app** `object | null` *required*
>
> Deneyimin ait olduğu uygulama.
>
> > [accordion] Özellikler
> >
> > **id** `string` *required*
> >
> > `app_` önekli uygulama kimliği.
> >
> > **icon\_url** `string` *required*
> >
> > Simge görsel URL'si. Her zaman bulunur — hiçbiri yüklenmediğinde varsayılan uygulama simgesi.
>
> **name** `string | null` *required*
>
> Deneyimin görünen adı.

**iframe\_link** `string | null` *required*

Uygulamanın kendi alan adındaki aynı hedef; Whop web ve mobil istemcileri buraya gitmek yerine bunu gömer. Yalnızca Whop uygulamalarını kendiniz oluşturuyorsanız önemlidir. Bildirim kendi `link` değerini taşıdığında `null`.

**link** `string | null` *required*

Bildirimin normal bir üst düzey gezinme olarak açtığı whop.com sayfası. Whop uygulamalarını kendiniz barındırmadığınız sürece kullanmanız gereken bağlantı budur. Bildirimin tıklanınca gidilecek bir hedefi olmadığında `null`.

**mentions\_me** `boolean` *required*

Kimliği doğrulanmış kullanıcıdan bu bildirimde doğrudan bahsedilip bahsedilmediği.

**rest\_path** `string | null` *required*

Varsa, bildirimin derin bağlantısına eklenen ek yol bilgisi.

**sender** `object | null` *required*

Bildirimi tetikleyen kullanıcı. Sistem tarafından oluşturulduğunda `null`.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `user_` önekli kullanıcı kimliği.
>
> **name** `string | null` *required*
>
> Görünen ad.
>
> **username** `string` *required*
>
> Herkese açık kullanıcı adı.

**subject** `string` *required*

Kullanıcıya gösterilen bildirimin başlık satırı.

**topic** `object | null` *required*

Bildirimin ait olduğu, gruplama ve tercih yönetimi için kullanılan konu kategorisi. Kategorize edilmemişse `null`.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `topic_` önekli bildirim konusu kimliği.
>
> **default\_preference\_value** `boolean` *required*
>
> Kullanıcı bir tercih belirlemediğinde bu konuya ait bildirimlerin varsayılan olarak etkin olup olmadığı.
>
> **is\_mention** `boolean` *required*
>
> Bu konunun yalnızca bahsetmeye dayalı bildirimleri işleyip işlemediği.
>
> **topic\_type** `string` *required*
>
> Konunun kapsamı: bir hesaba, bir kullanıcıya veya bir hesabın ekibine uygulanıp uygulanmadığı.
>
> Kullanılabilir seçenekler: `account`, `user`, `account_team`

```json Notification theme={null}
{
	"id": "ntfr_xxxxxxxxxxxxxx:xxxxxxxxxxxxx",
	"account": {
		"id": "biz_xxxxxxxxxxxxxx",
		"logo_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
		"route": "shine-time-auto-detailing",
		"title": "Shine Time Auto Detailing"
	},
	"content": "Tuesday 9:00 AM, Bay 2",
	"created_at": "2026-09-15T14:30:00.000Z",
	"experience": {
		"id": "exp_xxxxxxxxxxxxxx",
		"app": {
			"id": "app_xxxxxxxxxxxxxx",
			"icon_url": "https://pub-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.r2.dev/custom-perk-icon.svg"
		},
		"name": "Bookings"
	},
	"iframe_link": "https://whopappdomain0000001.apps.whop.com/experiences/exp_xxxxxxxxxxxxxx/bookings/upcoming",
	"link": "https://whop.com/joined/shine-time-auto-detailing/bookings-xxxxxxxxxxxxxx/app/bookings/upcoming/",
	"mentions_me": false,
	"rest_path": "/bookings/upcoming",
	"sender": {
		"id": "user_xxxxxxxxxxxxxx",
		"name": "Tanya Cole",
		"username": "tanyacole"
	},
	"subject": "Your ceramic coating is booked",
	"topic": {
		"id": "topic_xxxxxxxxxxxxxx",
		"default_preference_value": true,
		"is_mention": false,
		"topic_type": "user"
	},
	"attachment_url": "https://ui-avatars.com/api/?name=Tanya+Cole"
}
```


## Related topics

- [Create notification](https://docs.whop.com/tr/api-reference/legacy/notifications/create-notification.md)
- [List Notifications](https://docs.whop.com/tr/api-reference/notifications/list-notifications.md)
- [Send Notification](https://docs.whop.com/tr/api-reference/notifications/send-notification.md)
