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

Name	Label	Type	Description	Required
key	API key	STRING		true

Actions

Create Feature Request

Name: createFeatureRequest

Creates a new feature request.

Properties

Name	Label	Type	Description	Required
title	Feature Request Title	STRING	The name of the new feature request.	true
content	Feature Request Content	STRING	The content of the new feature request.	false
userEmail	User Email	STRING	The 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

Name	Type	Description
id	STRING	The ID of the new feature request.
date	STRING	Publish date of the new feature request.
visible	STRING	Whether this feature required is visible or not.
category	STRING	The category of the new feature request.
status	STRING	The status of the new feature request.
translations	ARRAY Items [{STRING(title), STRING(content), STRING(contentHtml), STRING(language), STRING(permalink), [STRING](images)}]
votesCount	INTEGER	The number of votes for the new feature request.
commentsCount	STRING	The number of comments for the new feature request.
notes	STRING	The notes for the new feature request.
filters	STRING	Segment filters for the new feature request.
internalUserEmail	STRING	Email of the user in your account who created this feature request (if created by a team member).
internalUserFirstname	STRING	First name of the user in your account who created this feature request (if created by a team member).
internalUserLastname	STRING	Last name of the user in your account who created this feature request (if created by a team member).
userId	STRING	ID of the end user who created this feature request (if created by an end user).
userEmail	STRING	Email of the end user who created this feature request (if created by an end user).
userFirstname	STRING	First name of the end user who created this feature request (if created by an end user).
userLastname	STRING	Last 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

Name	Label	Type	Description	Required
title	Title	STRING	Title of the new post.	true
content	Content	STRING	Content of the new post.	true
category	Category	STRING Options new, improvement, fix, comingsoon, announcement, other	Category of the new post.	true
userEmail	User Email	STRING	Email 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

Name	Type	Description
id	STRING	The ID of the new post.
date	STRING	Publication date of the new post.
dueDate	STRING	Expiration date of the new post.
published	STRING	Whether the new post is published or a draft.
category	STRING	Category of the new post.
feedbackEnabled	STRING	Whether this user feedback is enabled for this post.
reactionsEnabled	STRING	Whether reactions are enabled for this post.
translations	ARRAY 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

Name	Type	Description
url	STRING	URL for your standalone feed.

Output Example

{
  "url" : ""
}

New Comment

Name: newComment

Creates a new comment on selected post.

Properties

Name	Label	Type	Description	Required
postId	Post	STRING	ID of the post that will have the new comment.	true
text	Text	STRING	Text of the comment.	false
userId	User ID	STRING	ID of the user that is creating the new comment.	false
userEmail	User Email	STRING	Email of the user that is creating the new comment.	false
userFirstname	User First Name	STRING	First name of the user that is creating the new comment.	false
userLastname	User Last Name	STRING	Last 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

Name	Type	Description
id	STRING	ID of the new comment.
date	STRING	Publication date of the new comment.
text	STRING	Content of the new comment.
postTitle	STRING	Title of the post this comment was created on.
userId	STRING	ID of the user that created the new comment.
userEmail	STRING	Email of the user that created the new comment.
userFirstname	STRING	First name of the user that created the new comment.
userLastname	STRING	Last name of the user that created the new comment.
url	STRING	URL 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

Name	Label	Type	Description	Required
requestId	Feature Request ID	STRING	ID of the feature request that will have the new vote.	true
userId	User ID	STRING	ID of the user that is creating the new vote.	false
userEmail	User Email	STRING	Email of the user that is creating the new vote.	false
userFirstname	User First Name	STRING	First name of the user that is creating the new vote.	false
userLastname	User Last Name	STRING	Last 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

Name	Type	Description
id	STRING	The ID of the new vote.
date	STRING	Creation date of the new vote.
featureRequestTitle	STRING	Title of the feature request this vote is created on.
userId	STRING	ID of the user that created the new vote.
userEmail	STRING	Email of the user that created the new vote.
userFirstname	STRING	First name of the user that created the new vote.
userLastname	STRING	Last name of the user that created the new vote.
url	STRING	URL of the new vote in your dashboard.

Output Example

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

Triggers

New Post

Name: newPost

Triggers when a new post is added.

Type: POLLING

Output

Type: ARRAY

Items Type: OBJECT

Properties

Name	Type	Description
autoOpen	BOOLEAN Options true, false	Whether the post is auto opened.
category	STRING	Category of the post.
clicks	INTEGER	How many clicks does the post have.
date	DATE	Date when the post was created.
feedbackEnabled	BOOLEAN Options true, false	Whether the users can give feedback on the post.
feedbacks	INTEGER	How many feedbacks does the post have.
negativeReactions	INTEGER	How many negative reactions does the post have
neutralReactions	INTEGER	How many neutral reactions does the post have
positiveReactions	INTEGER	How many positive reactions does the post have
published	BOOLEAN Options true, false	Whether the post is published.
reactionsEnabled	BOOLEAN Options true, false	Whether the reactions are enabled.
translations	ARRAY Items [{STRING(category), STRING(content), STRING(contentHtml), STRING(language), STRING(postUrl), STRING(title)}, INTEGER($uniqueViews), INTEGER($views)]

JSON Example

{
  "label" : "New Post",
  "name" : "newPost",
  "type" : "beamer/v1/newPost"
}

Additional Instructions

Connection Setup

Find API Key

Navigate to your Beamer dashboard.
Click on Settings.
Click on API.
Click on Create new API key.
Enter name of your new API key.
Enable everything and Copy your API key.

Beamer

On this page