Sign in

Admin

Event Feeds and Calendar Subscriptions

Event Feeds (Admin > Event Feeds, at /admin/feeds) publish your events as web feeds that other websites and calendar apps can subscribe to. Instead of re-keying events on your marketing site, point the site or a calendar app at a feed URL and it stays current on its own.

Event Feeds

Three feed formats are offered. They carry the same events and differ only in which tool reads them.

FormatBest forRecommendation
RSSFeed readers and website plug-ins that import posts.Use when a webmaster asks for an RSS or Atom-style feed.
JSONDevelopers who want to render events on their own site with code.Use when a developer will build the listing; it is also the format shown in Preview by default.
iCalCalendar apps (Google Calendar, Outlook, Apple Calendar) that subscribe to a link.Use to let attendees or staff add all your events to their calendar.

Each feed event carries title, description (with formatting removed), start and end time, time zone, venue name, thumbnail image, the event's preview link and last-modified time.

Enable public feeds

The master switch. While it is off, the three Public Feed URLs are greyed out and the page shows "Feeds are currently disabled"; anyone requesting a feed URL gets a not-found response. Turning it on saves immediately.

Public Feed URLs

Copy URL (the clipboard button) next to RSS, JSON or iCal copies the full link for your org. Paste it into the website or calendar app.

A public feed only lists events whose Publish checkbox (Visible) is checked in Salesforce. Draft or unpublished events never appear in the public URLs.

Settings

FieldWhat it doesRecommendation
Feed titleThe title shown by feed readers and calendar apps. Leave blank to use your organization's name.Set it to something attendees recognize, such as "Acme Conferences". Applies to all three formats.
Maximum eventsA slider from 10 to 200 in steps of 10 (default 100). Upcoming events come first; anything beyond the cap is dropped.Keep it as low as your website needs. A homepage widget needs 10 to 20; a full calendar subscription may want 100 or more.
Include past eventsOff (default) lists only events that have not ended. On also lists events that already happened, still limited by Maximum events.Leave off for "upcoming events" widgets. Turn on for an archive or when a calendar should keep history.

Changes to Feed title, Maximum events and Include past events only take effect after you click Save. The Enable public feeds switch saves on its own.

Preview

Choose the RSS, JSON or iCal tab to load a sample of the feed as it would currently be served, so you can check titles and dates before sharing the URL. Preview uses your saved settings (Save first) and, unlike the public URLs, also includes events that are not published, so it is not an exact picture of what the public sees.

Feed tokens

A feed token upgrades a feed URL from public to private. Add ?token=YOUR_TOKEN to the end of a feed URL and the feed also includes events that are not published, in addition to the published ones. Without a token, only published events appear.

  1. Under Feed Tokens click Create Token.
  2. Enter a Token Label that says who or what will use it, for example "Internal staff calendar".
  3. Click Create Token and copy the token immediately. It is shown only once and cannot be recovered; the Done button closes the screen.
  4. Append it to the feed URL as ?token=... in the tool that will read the feed.
Column or actionWhat it doesRecommendation
Token LabelYour own name for the token. The list also shows the creation date. Click a header to sort.Use one token per consumer so you can revoke one without affecting the others.
RevokeAfter confirmation, permanently disables the token. Anything still using it stops receiving unpublished events (it falls back to the public feed).Revoke as soon as a staff member or partner no longer needs access, or if a URL with a token was shared by mistake.

Treat a tokenized feed URL like a password. Anyone with the link can see unpublished events. Do not paste it on a public web page or into a widget that exposes its source.

Event PM Calendar Feed (Blackthorn staff only)

Event PM Calendar Feed (/admin/event-pm-calendar) creates private calendar subscription links for milestone and contract deadlines. It depends on Milestones & Deadlines and Contract & Deadline Register, which are not generally available, and the page is hidden from customer orgs at GA. You will not see it in your Admin menu; it is listed here only so the URL is documented. When neither Milestones & Deadlines nor Contract & Deadline Register is on, the page warns that the feed returns nothing.

Event feeds and tokens are available to org admins only.