Notification Channels
Configure how you receive checkpoint notifications. Enable one or more channels to stay informed through your preferred methods.
Receive checkpoint notifications in your inbox. No setup required — notifications are sent to your account email.
- Go to Settings → Notifications
- Enable Email under MCP Checkpoint Notifications
- Click Save
Notifications are sent to the email address associated with your Instructionly account. To change it, update your email in Settings → Profile.
SMS
Get text messages when your AI needs attention. Perfect for urgent notifications when you're away from your desk.
Step 1: Add Your Phone Number
- Go to Settings → Profile
- Select your country code from the dropdown
- Enter your phone number
- Click Save Changes or Save & Verify
Step 2: Verify Your Phone Number
Phone verification is required before SMS notifications can be sent. This ensures messages are delivered to the correct number.
- After saving your phone number, click Verify Phone
- Click Send Verification Code to receive an SMS with a 6-digit code
- Enter the code and click Verify
SMS notifications will not be sent (and you won't be charged) until your phone number is verified. Look for the green "Verified" badge next to your phone number in Profile settings.
Step 3: Enable SMS Notifications
- Go to Settings → Notifications
- Enable SMS under MCP Checkpoint Notifications
- Click Save
SMS costs vary by destination country based on carrier charges. US numbers cost approximately 0.25 credits per message. See Pricing for details.
Phone Number Format
Enter your phone number in international format with the country code:
- United States:
+1 555 123 4567 - United Kingdom:
+44 20 7123 4567 - Germany:
+49 30 12345678 - Brazil:
+55 11 91234 5678
Webhook
Send notifications to any HTTPS URL. Integrate with Slack, Discord, or build custom integrations with your own systems.
Step 1: Configure Webhook URL
- Go to Settings → Webhooks
- Enter your webhook URL (must be HTTPS)
- Click Save
Step 2: Enable Webhook Notifications
- Go to Settings → Notifications
- Enable Webhook under MCP Checkpoint Notifications
- Click Save
Step 3: Test Your Webhook
- In Settings → Webhooks, click Send Test
- Verify your endpoint received the test notification
Payload Format
Instructionly sends a JSON payload with the following structure:
{
"event": "checkpoint_notification",
"type": "completion",
"text": "Task completed: Refactored authentication module",
"content": "Task completed: Refactored authentication module",
"sessionId": "abc-123",
"timestamp": "2025-01-15T10:30:00.000Z"
}
Platform Guides
For step-by-step integration guides with popular platforms:
- Slack Integration — Receive notifications in Slack channels
- Discord Integration — Receive notifications in Discord channels
- Custom Apps — Build your own integrations
Using Multiple Channels
You can enable any combination of channels. When a checkpoint is reached, notifications are sent to all enabled channels simultaneously.
Common configurations:
- Email only — Simple setup, good for non-urgent tasks
- Email + SMS — Get texts for immediate awareness, email for records
- Webhook only — Route all notifications to Slack/Discord or custom systems
- All three — Maximum coverage for critical workflows
If you enable multiple channels, each one incurs its own cost. For example, Email (0.25) + SMS (~0.34 for US) = ~0.59 credits per notification.