Tygash + Claude Code

Add agent-native push notifications to your Claude Code workflow. 30 seconds.

Step 1: Get your API key

Add to your project's .env file:

CopyTYGASH_BASE_URL=https://tygash.com
TYGASH_API_KEY=your_agent_key_here

No key yet? Sign up free -- your agent key is generated automatically on signup.

Step 2: Send your first notification

Copycurl -X POST ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/send \
  -H "Authorization: Bearer ${TYGASH_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Hello from your agent!",
    "body": "Your first push notification.",
    "topic": "general",
    "channels": ["web", "ios", "android"]
  }'

Response:

{
  "id": "msg_abc123",
  "status": "sent",
  "delivered": { "web": 842, "ios": 1205, "android": 967 },
  "total": 3014,
  "latency_ms": 38
}

Step 3: Add to CLAUDE.md

Copy this into your project's CLAUDE.md file. Claude Code reads it at session start and gains full Tygash integration:

Copy# Tygash Push Notification Integration

This project uses Tygash for agent-native push notifications.
API base: ${TYGASH_BASE_URL}. Auth: Bearer ${TYGASH_API_KEY}.
EVERY request MUST include:
  -H "Authorization: Bearer $TYGASH_API_KEY"
  -H "Content-Type: application/json"

## Send a notification
POST ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/send
Body: { "title": "...", "body": "...", "topic": "...", "channels": ["web","ios","android"] }

## Register a device
POST ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/devices/register
Body: { "platform": "web|ios|android", "token": "device_push_token", "metadata": {} }

## Create a topic
POST ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/topics
Body: { "name": "price-alerts", "description": "Price drop notifications" }

## Subscribe devices to topic
POST ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/topics/:topicId/subscribe
Body: { "deviceIds": ["device_1", "device_2"] }

## Send to a topic
POST ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/send
Body: { "title": "...", "body": "...", "topic": "price-alerts", "channels": ["web","ios","android"] }

## Check delivery
GET ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/history
GET ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/stats

## Templates
POST ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/templates
Body: { "name": "welcome", "title": "Welcome {{name}}!", "body": "Thanks for signing up." }

## Campaigns
POST ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/campaigns
Body: { "name": "Black Friday", "templateId": "...", "segmentId": "...", "scheduledAt": "ISO" }

## Segments
POST ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/segments
Body: { "name": "active-users", "filters": { "platform": "ios", "lastActive": ">7d" } }

## Knowledge (compliance, delivery, audience)
GET ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/knowledge/tree
POST ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/knowledge/query
Body: { "domain": "compliance", "query": "GDPR consent for marketing push" }

## Channel config
GET ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/channels/config
PUT ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/channels/config
Body: { "webPush": { "vapidPublicKey": "...", "vapidPrivateKey": "..." } }

Step 4: Register a device

Copycurl -X POST ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/devices/register \
  -H "Authorization: Bearer ${TYGASH_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "web",
    "token": "endpoint_from_pushsubscription",
    "metadata": { "browser": "chrome", "os": "macos" }
  }'

Step 5: Create a topic

Copycurl -X POST ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/topics \
  -H "Authorization: Bearer ${TYGASH_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "price-alerts",
    "description": "Notify when watched items drop in price"
  }'

Step 6: Send to a topic

Copycurl -X POST ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/send \
  -H "Authorization: Bearer ${TYGASH_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Price Drop!",
    "body": "Nike Air Max now 30% off",
    "topic": "price-alerts",
    "channels": ["web", "ios", "android"]
  }'

Step 7: Check delivery

Copy# Get notification history
curl "${TYGASH_BASE_URL}/saas/api/v1/sdk/push/history" \
  -H "Authorization: Bearer ${TYGASH_API_KEY}"

# Get delivery stats
curl "${TYGASH_BASE_URL}/saas/api/v1/sdk/push/stats" \
  -H "Authorization: Bearer ${TYGASH_API_KEY}"

Step 8: Run a campaign

Copy# Create a template
curl -X POST ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/templates \
  -H "Authorization: Bearer ${TYGASH_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "flash-sale",
    "title": "Flash Sale: {{discount}}% off!",
    "body": "{{itemName}} is on sale. Ends {{endTime}}."
  }'

# Create a campaign
curl -X POST ${TYGASH_BASE_URL}/saas/api/v1/sdk/push/campaigns \
  -H "Authorization: Bearer ${TYGASH_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Black Friday 2026",
    "templateId": "template_id_here",
    "segmentId": "segment_id_here",
    "scheduledAt": "2026-11-27T09:00:00Z"
  }'

Quotas