Skip to content

Beamer

Beamer is a customer engagement platform that helps businesses communicate updates, collect feedback, and boost user engagement through in-app notifications, changelogs, and announcements.

Categories: productivity-and-collaboration

Type: beamer/v1


Connections

Version: 1

API Key

Properties

NameLabelTypeDescriptionRequired
keyAPI keySTRINGtrue

Actions

Create Feature Request

Name: createFeatureRequest

Creates a new feature request.

Properties

NameLabelTypeDescriptionRequired
titleFeature Request TitleSTRINGThe name of the new feature request.true
contentFeature Request ContentSTRINGThe content of the new feature request.false
userEmailUser EmailSTRINGThe email of the user that is creating the new feature request.false

Example JSON Structure

{
"label" : "Create Feature Request",
"name" : "createFeatureRequest",
"parameters" : {
"title" : "",
"content" : "",
"userEmail" : ""
},
"type" : "beamer/v1/createFeatureRequest"
}

Output

Type: OBJECT

Properties

NameTypeDescription
idSTRINGThe ID of the new feature request.
dateSTRINGPublish date of the new feature request.
visibleSTRINGWhether this feature required is visible or not.
categorySTRINGThe category of the new feature request.
statusSTRINGThe status of the new feature request.
translationsARRAY
Items [{STRING(title), STRING(content), STRING(contentHtml), STRING(language), STRING(permalink), [STRING](images)}]
votesCountINTEGERThe number of votes for the new feature request.
commentsCountSTRINGThe number of comments for the new feature request.
notesSTRINGThe notes for the new feature request.
filtersSTRINGSegment filters for the new feature request.
internalUserEmailSTRINGEmail of the user in your account who created this feature request (if created by a team member).
internalUserFirstnameSTRINGFirst name of the user in your account who created this feature request (if created by a team member).
internalUserLastnameSTRINGLast name of the user in your account who created this feature request (if created by a team member).
userIdSTRINGID of the end user who created this feature request (if created by an end user).
userEmailSTRINGEmail of the end user who created this feature request (if created by an end user).
userFirstnameSTRINGFirst name of the end user who created this feature request (if created by an end user).
userLastnameSTRINGLast name of the end user who created this feature request (if created by an end user).

Output Example

{
"id" : "",
"date" : "",
"visible" : "",
"category" : "",
"status" : "",
"translations" : [ {
"title" : "",
"content" : "",
"contentHtml" : "",
"language" : "",
"permalink" : "",
"images" : [ "" ]
} ],
"votesCount" : 1,
"commentsCount" : "",
"notes" : "",
"filters" : "",
"internalUserEmail" : "",
"internalUserFirstname" : "",
"internalUserLastname" : "",
"userId" : "",
"userEmail" : "",
"userFirstname" : "",
"userLastname" : ""
}

Create Post

Name: createPost

Creates a new post.

Properties

NameLabelTypeDescriptionRequired
titleTitleSTRINGTitle of the new post.true
contentContentSTRINGContent of the new post.true
categoryCategorySTRING
Options new, improvement, fix, comingsoon, announcement, other
Category of the new post.true
userEmailUser EmailSTRINGEmail of the user that is creating the new post.false

Example JSON Structure

{
"label" : "Create Post",
"name" : "createPost",
"parameters" : {
"title" : "",
"content" : "",
"category" : "",
"userEmail" : ""
},
"type" : "beamer/v1/createPost"
}

Output

Type: OBJECT

Properties

NameTypeDescription
idSTRINGThe ID of the new post.
dateSTRINGPublication date of the new post.
dueDateSTRINGExpiration date of the new post.
publishedSTRINGWhether the new post is published or a draft.
categorySTRINGCategory of the new post.
feedbackEnabledSTRINGWhether this user feedback is enabled for this post.
reactionsEnabledSTRINGWhether reactions are enabled for this post.
translationsARRAY
Items [{STRING(title), STRING(content), STRING(contentHtml), STRING(language), STRING(category), STRING(linkUrl), STRING(linkText), [STRING](images)}]

Output Example

{
"id" : "",
"date" : "",
"dueDate" : "",
"published" : "",
"category" : "",
"feedbackEnabled" : "",
"reactionsEnabled" : "",
"translations" : [ {
"title" : "",
"content" : "",
"contentHtml" : "",
"language" : "",
"category" : "",
"linkUrl" : "",
"linkText" : "",
"images" : [ "" ]
} ]
}

Get Feed

Name: getFeed

Get the URL for your feed.

Example JSON Structure

{
"label" : "Get Feed",
"name" : "getFeed",
"type" : "beamer/v1/getFeed"
}

Output

Type: OBJECT

Properties

NameTypeDescription
urlSTRINGURL for your standalone feed.

Output Example

{
"url" : ""
}

New Comment

Name: newComment

Creates a new comment on selected post.

Properties

NameLabelTypeDescriptionRequired
postIdPostSTRINGID of the post that will have the new comment.true
textTextSTRINGText of the comment.false
userIdUser IDSTRINGID of the user that is creating the new comment.false
userEmailUser EmailSTRINGEmail of the user that is creating the new comment.false
userFirstnameUser First NameSTRINGFirst name of the user that is creating the new comment.false
userLastnameUser Last NameSTRINGLast name of the user that is creating the new comment.false

Example JSON Structure

{
"label" : "New Comment",
"name" : "newComment",
"parameters" : {
"postId" : "",
"text" : "",
"userId" : "",
"userEmail" : "",
"userFirstname" : "",
"userLastname" : ""
},
"type" : "beamer/v1/newComment"
}

Output

Type: OBJECT

Properties

NameTypeDescription
idSTRINGID of the new comment.
dateSTRINGPublication date of the new comment.
textSTRINGContent of the new comment.
postTitleSTRINGTitle of the post this comment was created on.
userIdSTRINGID of the user that created the new comment.
userEmailSTRINGEmail of the user that created the new comment.
userFirstnameSTRINGFirst name of the user that created the new comment.
userLastnameSTRINGLast name of the user that created the new comment.
urlSTRINGURL of the new comment in your dashboard.

Output Example

{
"id" : "",
"date" : "",
"text" : "",
"postTitle" : "",
"userId" : "",
"userEmail" : "",
"userFirstname" : "",
"userLastname" : "",
"url" : ""
}

New Vote

Name: newVote

Creates a new vote on selected feature request.

Properties

NameLabelTypeDescriptionRequired
requestIdFeature Request IDSTRINGID of the feature request that will have the new vote.true
userIdUser IDSTRINGID of the user that is creating the new vote.false
userEmailUser EmailSTRINGEmail of the user that is creating the new vote.false
userFirstnameUser First NameSTRINGFirst name of the user that is creating the new vote.false
userLastnameUser Last NameSTRINGLast name of the user that is creating the new vote.false

Example JSON Structure

{
"label" : "New Vote",
"name" : "newVote",
"parameters" : {
"requestId" : "",
"userId" : "",
"userEmail" : "",
"userFirstname" : "",
"userLastname" : ""
},
"type" : "beamer/v1/newVote"
}

Output

Type: OBJECT

Properties

NameTypeDescription
idSTRINGThe ID of the new vote.
dateSTRINGCreation date of the new vote.
featureRequestTitleSTRINGTitle of the feature request this vote is created on.
userIdSTRINGID of the user that created the new vote.
userEmailSTRINGEmail of the user that created the new vote.
userFirstnameSTRINGFirst name of the user that created the new vote.
userLastnameSTRINGLast name of the user that created the new vote.
urlSTRINGURL of the new vote in your dashboard.

Output Example

{
"id" : "",
"date" : "",
"featureRequestTitle" : "",
"userId" : "",
"userEmail" : "",
"userFirstname" : "",
"userLastname" : "",
"url" : ""
}