Question 1

How do I create my first reminder?

Accepted Answer

Create an API key from the API Keys page, then send a POST request to /api/remind with your key in the Authorization header. Include the reminder title, scheduled time, and at least one recipient. See our API documentation at /docs for full details.

Question 2

How do API keys work?

Accepted Answer

API keys authenticate your requests to the Pingfyr API. Each key starts with 'rm_' and must be included as a Bearer token in the Authorization header. You can create multiple keys and revoke them at any time from the API Keys page.

Question 3

How can I test the API?

Accepted Answer

You can test the API using curl or any HTTP client. For example: curl -X POST https://pingfyr.com/api/remind -H 'Authorization: Bearer rm_your_key' -H 'Content-Type: application/json' -d '{"title": "Test", "fire_at": "2026-12-01T12:00:00Z", "recipients": ["you@example.com"]}'. See our API documentation at /docs for all available endpoints.

Question 4

What notification channels are available?

Accepted Answer

Pingfyr supports seven delivery channels: Email (paid plans — your own SMTP), Webhook, Slack, Discord, Telegram, OpenClaw, and Google Calendar (paid plans). Configure your email provider in Dashboard > Email Settings and connect your Google account in Dashboard > Settings > Google Calendar.

Question 5

How do I create or revoke an API key?

Accepted Answer

Navigate to the API Keys page in your dashboard. Click 'Create Key' to generate a new key. To revoke a key, click the delete button next to it. Revoked keys immediately stop working for all API requests.

Question 6

What permissions do API keys have?

Accepted Answer

Each API key has full access to create, update, and cancel reminders under your account. Keys are scoped to your user account and cannot access other users' data. Note that some channels (email and Google Calendar) are only available on paid plans — free plan users can use webhook, Slack, Discord, Telegram, and OpenClaw. All API key usage is tracked and visible in your delivery logs.

Question 7

What happens when I revoke a key that has active reminders?

Accepted Answer

Revoking an API key does not cancel its associated reminders. Existing reminders will continue to fire as scheduled. However, you will not be able to update or cancel those reminders using the revoked key — you will need to use a different active key.

Question 8

Are there rate limits on API keys?

Accepted Answer

Yes, API requests are rate-limited based on your plan. Rate limits are applied per API key to prevent abuse. If you exceed the limit, you will receive a 429 Too Many Requests response. See our API documentation at /docs for specific rate limit details.

Question 9

How does webhook delivery work?

Accepted Answer

When a reminder fires, Pingfyr sends a POST request to your configured webhook URL with the reminder data as JSON payload. Your endpoint should return a 2xx status code to confirm receipt. The delivery status is tracked and visible in your delivery logs.

Question 10

How do I troubleshoot webhook errors?

Accepted Answer

Check your delivery logs for the specific error. Timeout errors mean your endpoint did not respond within the allowed time. A 4xx error indicates a client-side issue (check your endpoint URL and authentication). A 5xx error indicates a server-side issue on your webhook receiver. Make sure your endpoint is publicly accessible and returns a 2xx response.

Question 11

What is the retry behavior for failed webhooks?

Accepted Answer

Pingfyr retries failed webhook deliveries up to 3 times with exponential backoff: the first retry after 1 second, the second after 5 seconds, and the third after 30 seconds. If all retries fail, the delivery is marked as failed in your logs.

Question 12

How can I test webhooks locally?

Accepted Answer

Use a tunneling tool like ngrok to expose your local server to the internet. Run 'ngrok http 3000' to get a public URL, then use that URL as your webhook endpoint when creating a reminder. You can also use services like webhook.site to inspect incoming payloads without running your own server.

Question 13

Why did my email delivery fail?

Accepted Answer

Email deliveries can fail for several reasons: the recipient address is invalid, the mailbox is full, the email was rejected by the recipient's server, or the address has been suppressed due to previous bounces. Check your delivery logs for the specific error message.

Question 14

How do I check delivery status?

Accepted Answer

Navigate to the Delivery Logs page in your dashboard. Each delivery shows its current status (pending, processing, delivered, failed) along with timestamps and any error messages. You can also check delivery status via the API. See our API documentation at /docs for details.

Question 15

What happens when a recipient is suppressed or bounced?

Accepted Answer

If a recipient address has previously bounced, future deliveries to that address may be suppressed to protect your sender reputation. Suppressed deliveries are logged with a 'suppressed' status. Contact support@pingfyr.com if you believe a suppression is incorrect.

Question 16

Can I send reminders to multiple recipients?

Accepted Answer

Yes, each reminder supports multiple recipients. Email reminders allow up to 100 recipients per send. Webhook, Slack, Discord, OpenClaw, and Google Calendar channels support 1 recipient per reminder. Telegram supports multiple recipients based on your plan. Each recipient counts toward your monthly quota — Free: 100/month, Starter: 20,000/month, Pro: 100,000/month.

Question 17

How do recurring reminders work?

Accepted Answer

Set the repeat field to 'daily', 'weekly', 'monthly', or 'custom' when creating a reminder. For custom schedules, provide a cron expression (e.g. '0 9 * * 1' for every Monday at 9am UTC). Recurring reminders automatically schedule the next occurrence after each delivery. To stop a recurring reminder, cancel it via the API or dashboard.

Question 18

How does timezone handling work?

Accepted Answer

All fire_at timestamps must be in ISO 8601 UTC format. When using the CLI's --at flag or recurring reminders, provide an IANA timezone (e.g. 'Europe/Berlin', 'America/New_York') via the timezone field. Pingfyr uses this timezone for natural language parsing and for calculating recurring reminder times. If no timezone is specified, UTC is used by default.

Question 19

Which channels are available on the Free plan?

Accepted Answer

The Free plan includes webhook, Slack, Discord, Telegram, and OpenClaw channels. Email and Google Calendar are available on Starter, Pro, and Enterprise plans. The Free plan allows up to 50 reminders and 100 recipients per month.

Question 20

How do I upgrade or downgrade my plan?

Accepted Answer

Navigate to the Billing page in your dashboard. You can upgrade to Starter or Pro plans via Stripe checkout. Downgrades take effect at the end of your current billing period. For Enterprise plans, contact support@pingfyr.com.

Question 21

What happens when I reach my plan limits?

Accepted Answer

Pingfyr uses a dual-limit system: both reminders and recipients must have capacity. When you reach either limit, new reminder creation will be blocked until the next billing cycle or until you upgrade. Existing scheduled reminders will continue to fire normally.

Question 22

What is the grace period for overdue payments?

Accepted Answer

If your payment fails, your subscription enters a 'past due' state with a 3-day grace period. During this period, your reminders continue to work normally. If payment is not resolved within 3 days, your account is downgraded to the Free plan limits.

Question 23

How do I cancel my subscription?

Accepted Answer

You can cancel your subscription from the Billing page by accessing the Stripe customer portal. Cancellation takes effect at the end of your current billing period, and you retain access to your paid features until then. Your data and reminders are preserved if you resubscribe later.

Scheduled Delivery API

Four ways to use Pingfyr

REST API

MCP Server

CLI

Dashboard

Pingfyr in action

Wake your agents on schedule

Follow up with Acme Corp

Email reminders your users love

Cron jobs that talk to your team

Reminders that work for you, not your users

Deliver everywhere

Email

Webhook

OpenClaw

Slack

Discord

Telegram

Google Calendar

Simple, transparent pricing

How Pingfyr Works

Stay in the loop