Overview

Awareness Planner integrations let your saved awareness days flow into your existing tools and workflows. Instead of manually checking the planner, you can receive automatic updates wherever you work.

All integrations are configured from the Integrations modal — click “Integrations” in the planner header bar.

API token

Most integrations use a personal API token for authentication. Your token is a 32-character string that identifies your account and grants access to your saved events.

Finding your token

Open the Integrations modal — your token is displayed at the top of the settings panel. You can copy it to use in feed URLs and webhook configurations.

Regenerating your token

If you need to revoke access (e.g. you shared a feed URL you no longer want active), click “Regenerate Token”. This creates a new token and immediately invalidates the old one.

iCal feed

The iCal feed provides a live-updating calendar subscription. Any calendar app that supports iCal subscriptions (most do) can subscribe to your feed and automatically show your saved awareness days.

Setting up an iCal subscription

1. Open the Integrations modal from the planner header.
2. Find the iCal feed section and select which calendar list to generate a feed for.
3. Copy the feed URL — it includes your API token for authentication.
4. Add to your calendar app:
   • Google Calendar: Settings > Add calendar > From URL > paste the feed URL
   • Apple Calendar: File > New Calendar Subscription > paste the URL
   • Outlook: Add calendar > Subscribe from web > paste the URL

The feed refreshes approximately every 6 hours. When you add or remove events from your calendar in Awareness Planner, the changes will appear in your subscribed calendar app at the next refresh.

RSS feed

The RSS feed provides your saved events in RSS 2.0 XML format, compatible with any RSS reader or aggregator. This is useful for:

• Following upcoming events in an RSS reader like Feedly or Inoreader
• Feeding event data into automation tools like Zapier or Make
• Displaying events on a website using an RSS widget

Setting up the RSS feed

1. Open the Integrations modal from the planner header.
2. Find the RSS feed section and select your calendar list.
3. Copy the feed URL and paste it into your RSS reader or automation tool.

Each RSS item includes the event title, description, start date, categories, and a link to the full event page on Awareness Days.

Embeddable widget

The embeddable widget lets you display upcoming awareness days from your saved calendar on any website. It’s a single JavaScript snippet that renders a styled event list.

Setting up the widget

1. Open the Integrations modal and find the Embed section.
2. Select a calendar list to display events from.
3. Copy the embed code — a single <script> tag.
4. Paste it into your website’s HTML where you want the event list to appear.

The widget shows the next 20 upcoming events from your selected calendar. Each event links to its page on Awareness Days in a new tab.

Styling and branding

The widget is self-contained and responsive. On the free plan, it includes a “Powered by Awareness Days” footer link. On Pro and Team plans, you can enable white-label mode to remove the branding.

Webhooks

Webhooks send a push notification to a URL you specify when upcoming events are approaching. This lets you build custom integrations — for example, triggering a Slack bot, updating a project management tool, or starting an automated workflow.

Setting up a webhook

1. Open the Integrations modal and find the Webhook section.
2. Enter your webhook URL — the endpoint that will receive the notification.
3. Set the advance notice — how many days before an event the notification should fire (1–30 days).
4. Select a calendar list to monitor.
5. Click “Test Webhook” to send a sample payload and verify your endpoint is receiving data correctly.

Payload format

Webhooks send a JSON payload containing:

• source — “awareness-planner”
• type — “upcoming-events”
• message — a human-readable summary
• events — an array of event objects with titles, dates, categories, and URLs

Slack notifications

Connect Awareness Planner to a Slack channel to receive formatted digests of upcoming awareness days. Available on the Team plan.

Setting up Slack

1. Create an Incoming Webhook in your Slack workspace (Slack admin > Apps > Incoming Webhooks > Add New Webhook).
2. Copy the webhook URL that Slack provides.
3. Open the Integrations modal in Awareness Planner and paste the URL in the Slack section.
4. Choose a frequency — daily or weekly digests.
5. Select a calendar list to receive notifications for.
6. Click “Test” to send a sample message to your Slack channel and confirm it’s working.

Slack messages use Block Kit formatting with headers, event sections, and dividers for easy readability.

Email digests

Email digests send you a scheduled reminder of upcoming awareness days from your saved calendar. No setup beyond enabling it — digests go to the email address on your account.

Email digests are enabled by default for new accounts. You can change the frequency or disable them in the Integrations modal. Every email includes a one-click unsubscribe link.