← Tools Reference

Beamer

Beamer integration (Communication, Productivity). Imported from open-connector.

API key4 toolshttps://api.getbeamer.com/v0
GET
beamer_get_feed_url
Retrieve the standalone Beamer feed URL with optional language and segmentation filters.

/url

3 parameters
ParamTypeRequiredDescription
languagestringoptionalA two-letter ISO-639 language code used by Beamer for feed localization.
filterByUrlbooleanoptionalWhether URL segmentation should be applied to the feed URL.
filterstringoptionalAn optional segmentation filter string to apply.
GET
beamer_count_unread_posts
Count unread Beamer posts for one end-user context.

/unread/count

2 parameters
ParamTypeRequiredDescription
userIdstringoptionalThe end-user identifier used together with filterByUserId.
filterByUserIdbooleanoptionalWhether to include single-user posts that match the provided userId.
GET
beamer_list_posts
List existing Beamer posts with optional changelog, audience, and analytics filters.

/posts

21 parameters
ParamTypeRequiredDescription
filterstringoptionalRetrieve posts with a matching segmentation filter.
forceFilterstringoptionalOnly retrieve posts that match this segmentation filter.
filterUrlstringoptionalRetrieve posts with a matching segmentation URL.
dateFromstringoptionalAn ISO-8601 date-time string accepted by the Beamer API.
dateTostringoptionalAn ISO-8601 date-time string accepted by the Beamer API.
languagestringoptionalA two-letter ISO-639 language code used by Beamer for localized content.
categorystringoptionalRetrieve posts for a specific category.
publishedbooleanoptionalWhether to retrieve only published or only draft posts.
archivedbooleanoptionalWhether to retrieve only archived or only non-archived posts.
expiredbooleanoptionalWhether to retrieve only expired or only non-expired posts.
filterByUserIdbooleanoptionalWhether to include single-user posts that match the provided userId.
userFirstNamestringoptionalThe end user's first name used for analytics attribution.
userLastNamestringoptionalThe end user's last name used for analytics attribution.
userEmailstringoptionalThe end user's email used for analytics attribution.
userIdstringoptionalThe end-user identifier used for analytics attribution.
traceableLinksbooleanoptionalWhether Beamer should rewrite links into tracked URLs.
ignoreRequestDetailsbooleanoptionalWhether backend request IP, browser, OS, and geolocation details should be igno…
saveViewsbooleanoptionalWhether fetching these posts should save views in Beamer analytics.
maxResultsintegeroptionalThe maximum number of posts to return.
pageintegeroptionalThe results page to retrieve.
ignoreFiltersbooleanoptionalWhether Beamer should ignore segmentation filters when returning posts.
POST
beamer_create_post
Create a new Beamer changelog post with one or more translations.

/posts

25 parameters
ParamTypeRequiredDescription
titlearrayrequiredThe translated post titles in Beamer order.
contentarrayrequiredThe translated post content values in the same order as the titles.
categorystringoptionalThe category to assign to the new post.
publishbooleanoptionalWhether to publish the post immediately.
archivebooleanoptionalWhether the post should start archived.
pinnedbooleanoptionalWhether the post should be pinned to the top of the feed.
showInWidgetbooleanoptionalWhether the post should appear in the embedded widget.
showInStandalonebooleanoptionalWhether the post should appear in the standalone feed.
boostedAnnouncementstringoptionalThe boosted announcement treatment to apply to the post.
linkUrlarrayoptionalThe translated CTA URLs in Beamer order.
linkTextarrayoptionalThe translated CTA labels in Beamer order.
linksInNewWindowbooleanoptionalWhether links should open in a new tab or window.
datestringoptionalAn ISO-8601 date-time string accepted by the Beamer API.
dueDatestringoptionalAn ISO-8601 date-time string accepted by the Beamer API.
languagearrayoptionalThe translated language codes in Beamer order.
filterstringoptionalThe segmentation filter string for this post.
filterUserIdstringoptionalThe single-user filter identifier or semicolon-separated identifiers for this p…
filterUrlstringoptionalThe URL targeting filter string for this post.
enableFeedbackbooleanoptionalWhether feedback should be enabled for the post.
enableReactionsbooleanoptionalWhether reactions should be enabled for the post.
enableSocialSharebooleanoptionalWhether social sharing should be enabled for the post.
autoOpenbooleanoptionalWhether the Beamer sidebar should auto-open for recipients.
sendPushNotificationbooleanoptionalWhether a web push notification should be sent for the post.
userEmailstringoptionalThe email of the Beamer account user creating this post.
fixedBoostedAnnouncementbooleanoptionalWhether a boosted top-bar announcement should stay fixed on screen.