DoNotify Skill

You can send immediate voice call reminders or schedule future calls through the DoNotify API.

Authentication

All requests require:

• Header: Authorization: Bearer $DONOTIFY_API_TOKEN
• Header: Accept: application/json
• Base URL: $DONOTIFY_URL (default: https://donotifys.com)

Endpoints

Check Usage

Check the user's plan, remaining notifications, and phone number status.

GET $DONOTIFY_URL/api/usage

Response:

{
  "plan": "starter",
  "notification_limit": 30,
  "used_this_month": 5,
  "remaining": 25,
  "phone_number_set": true
}

Before placing calls, check that phone_number_set is true and remaining is greater than 0. If the phone number is not set, tell the user to configure it in their DoNotify profile.

Call Now

Place an immediate voice call to the user's phone.

POST $DONOTIFY_URL/api/call-now
Content-Type: application/json

{
  "title": "Pick up groceries",
  "description": "Milk, eggs, bread from Trader Joe's"
}

Parameters:

• title (required, string, max 255) — What the call is about. This is spoken aloud.
• description (optional, string, max 1000) — Additional details spoken after the title.

{
  "success": true,
  "reminder_id": 42,
  "call_uuid": "abc-123",
  "status": "completed"
}

Error response (422 if no phone number, 500 if call fails):

{
  "success": false,
  "reminder_id": 42,
  "error": "Phone number not configured. Update your profile first.",
  "status": "failed"
}

Schedule Reminder

Schedule a voice call for a future time.

POST $DONOTIFY_URL/api/reminders
Content-Type: application/json

{
  "title": "Team standup",
  "call_at": "2025-06-15T14:45:00Z",
  "description": "Prepare sprint update",
  "event_time": "2025-06-15T15:00:00Z"
}

Parameters:

• title (required, string, max 255) — Reminder title spoken in the call.
• call_at (required, ISO 8601 datetime, must be in the future) — When to place the call.
• description (optional, string, max 1000) — Extra details.
• event_time (optional, ISO 8601 datetime) — The actual event time, if different from call time.

{
  "success": true,
  "reminder": {
    "id": 43,
    "title": "Team standup",
    "description": "Prepare sprint update",
    "call_at": "2025-06-15T14:45:00+00:00",
    "event_time": "2025-06-15T15:00:00+00:00",
    "status": "pending"
  }
}

Behavior Guidelines

• When the user says "call me now about X" or "remind me right now about X", use the Call Now endpoint.
• When the user says "remind me at [time] about X" or "call me at [time] for X", use the Schedule Reminder endpoint. Convert the user's natural language time to ISO 8601 for call_at.
• When the user asks "how many reminders do I have left" or "check my usage", use the Usage endpoint.
• Always check usage first if you're unsure whether the user has remaining notifications.
• If phone_number_set is false, tell the user to set their phone number at their DoNotify profile page before placing calls.
• Keep titles concise and descriptive — they are read aloud during the call.