Beaconstac provides a platform for creating and managing QR codes and beacons, enabling businesses to engage customers through proximity marketing and track analytics.
Beaconstac provides a platform for creating and managing QR codes and beacons, enabling businesses to engage customers through proximity marketing and track analytics. On Nagent, Beaconstac is exposed as a fully-configurable marketing integration that any agent can call — 21 actions, and API key authentication. No code is required to wire Beaconstac into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Beaconstac to automate the kinds of tasks marketing teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Beaconstac into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Beaconstac, with input parameters and output schema. Drop these into any step of an agent built in Helix.
BEACONSTAC_CREATE_PLACETool to create a new place for location-based assets. Use when you need to register a new physical place under an organization.
Input parameters
Name of the place.
Physical address of the place.
Latitude coordinate of the place.
Longitude coordinate of the place.
ID of the organization this place belongs to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_CREATE_QR_TEMPLATECreates a new QR Code template with customizable design attributes. QR Code templates allow you to define reusable design presets for QR codes in your organization. You can customize colors, patterns, shapes, gradients, logos, frames, and more. Once created, templates can be applied to multiple QR codes for consistent branding. Use this when you need to: - Create branded QR code designs for your organization - Set up reusable design presets for QR code campaigns - Define custom styling including colors, patterns, logos, and frames
Input parameters
Arbitrary metadata for the QR Code template
Name of the QR Code template
Margin to apply around the QR Code (in pixels)
Whether to set this template as the default for the organization
Scale factor for the QR Code dots (0-1)
Hex color code for dark modules (e.g., '#000000' for black)
Text displayed within the frame (e.g., 'SCAN ME')
URL of the logo image
Scale factor for the logo (0.1-0.6)
Hex color code for light background (e.g., '#FFFFFF' for white)
Hex color code for frame (e.g., '#000000')
Style of the QR Code frame (banner, box, balloon, or circular)
Pattern style for data modules
Hex color code for eye-ball modules (e.g., '#FF0000')
Shape of the eye-ball modules
Gradient type for the QR Code (none, linear, radial, vertical)
ID of the organization to which this template belongs
Hex color code for eye-frame modules (e.g., '#00FF00')
Shape of the eye-frame modules (outer part of QR code positioning patterns)
Hex color code for frame text (e.g., '#FFFFFF')
Hex color code for background (e.g., '#FFFFFF')
URL of the background image
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_CREATE_TAGTool to create a new tag for organizing QR Codes and other objects. Use when you need to categorize QR Codes under a specific organization.
Input parameters
Name of the tag. Must not exceed 128 characters. Supports Unicode characters including emoji.
ID of the organization this tag belongs to. Use BEACONSTAC_LIST_ORGANIZATIONS to get valid organization IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_CREATE_USERTool to create a new User. Use when onboarding a new user under your organization (Reseller plan and above).
Input parameters
Email address of the User.
Password for the User. Uses default if not provided.
Username used to login.
Last name of the User.
First name of the User.
ID of the organization to which the user belongs.
Billing email for the User. If not provided, defaults to username@example.com.
Customer plan for the user: ST=Starter, LT=Lite, BA=Basic, PR=Premium, RE=Reseller, WL=Whitelabel, EN=Enterprise.
URL to the User's profile picture.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_DELETE_QR_CODETool to delete a QR Code by its ID. Use when you need to remove an existing QR Code after validation.
Input parameters
Unique identifier of the QR Code to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_DELETE_QR_TEMPLATETool to delete a QR Code template by its ID. Use when you need to permanently remove a QR Code template that is no longer needed.
Input parameters
Unique identifier of the QR Code template to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_DELETE_TAGTool to delete a tag by its ID. Use when you need to remove an existing Tag after validation.
Input parameters
Unique identifier of the Tag to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_LIST_BULK_QR_CODESTool to list Bulk QR Code collections. Use when you need to filter, search, or order your bulk QR Code collections.
Input parameters
Page number for pagination (1-based index).
Full-text search on collection names.
Field to order results by. Prefix with '-' for descending. Allowed fields: name, created, updated.
Number of collections per page, must be between 1 and 100.
Filter by QR data type: 1=Website, 2=SMS, 3=Phone, 4=Email, 5=vCard, 6=Text.
Filter collections by name containing this substring (case-insensitive).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_LIST_ORGANIZATIONSList all organizations accessible to the authenticated account. Use this tool when you need to: - Get a list of all organizations the user has access to - Retrieve organization details including IDs, names, and configuration - Access organization feature permissions and account limits - Check subscription status and owner information The response includes comprehensive organization data with pagination support.
Input parameters
Page number for pagination. Use this to navigate through multiple pages of results.
Number of organizations to return per page. Controls the pagination size.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_LIST_PLACESTool to list your Places. Use when you need to browse or search your account's Places with filtering and ordering.
Input parameters
Filter by place name. Supports exact match.
Page number to retrieve, must be >= 1.
Search for place names matching this value (case-insensitive partial match).
Comma-separated ordering fields; prefix with '-' for descending. Fields: name, created, updated, address.
Number of places per page, must be between 1 and 100.
Filter by place name (case-insensitive contains).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_LIST_QR_TEMPLATESTool to list all QR code templates in your account. Use when you need to filter and paginate templates.
Input parameters
Page number for pagination (1-based index).
Number of items per page.
ID of the organization to list templates for.
Case-insensitive substring to filter template names.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_LIST_TAGSTool to list all tags with optional filtering and pagination. Use when you need to browse or search tags in your account.
Input parameters
Page number to retrieve, must be >= 1.
Field by which to order results. Prefix with '-' for descending.
Number of tags per page, must be between 1 and 100.
Filter tags by name containing this substring.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_LIST_USERSTool to list all users with optional filtering, searching, ordering, and pagination. Use when you need to retrieve user records across your organization.
Input parameters
Page number to retrieve, must be >= 1.
Full-text search across username, email, user_group, first_name, and last_name.
Comma-separated ordering fields. Supported: username, email, date_joined, user_group, first_name, last_name. Prefix with '-' for descending order.
Number of users per page, must be between 1 and 100.
Filter by email exact match.
Filter by organization ID exact match.
Filter by customer plan exact match.
Filter by date joined greater than this ISO 8601 timestamp.
Filter by date joined less than this ISO 8601 timestamp.
Filter by username exact match.
Filter by date joined greater than or equal to this ISO 8601 timestamp.
Filter by date joined less than or equal to this ISO 8601 timestamp.
Filter by email case-insensitive substring.
Filter by last name exact match.
Filter by first name exact match.
Filter by subscription state exact match.
Filter by username case-insensitive substring.
Filter by last name case-insensitive substring.
Filter by first name case-insensitive substring.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_PERIOD_OVERVIEWTool to get period overview analytics for products including counts, impressions, and conversion percentage. Use after specifying the product_type and time interval.
Input parameters
Organization ID for which analytics overview is requested.
Type of product to fetch overview analytics for.
End time in EPOCH milliseconds.
Start time in EPOCH milliseconds.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_PRODUCT_OVERVIEWTool to get analytics overview for a specified product type over a given time interval. Use after specifying the product type and time range to obtain summary metrics.
Input parameters
Organization ID for which overview is requested.
Type of product to fetch overview for.
End time in EPOCH milliseconds.
Start time in EPOCH milliseconds.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_RETRIEVE_QR_CODERetrieve detailed information about a specific QR Code by its ID. Returns QR code properties including name, type (static/dynamic), short URL, encoded data, design attributes, scan count, organization, and timestamps. Use this when you need to fetch, verify, or inspect QR Code details after creation or update.
Input parameters
Unique identifier of the QR Code to retrieve. Must be a positive integer.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_RETRIEVE_USERTool to retrieve the details of an existing User by ID. Use when you need to fetch a user's profile after confirming its existence.
Input parameters
Unique identifier of the User to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_UPDATE_PLACETool to update the specified Place by ID. Use after retrieving the Place to modify its details, such as name, address, or coordinates.
Input parameters
New name for the Place.
Address of the Place.
Latitude coordinate of the Place.
Unique identifier of the Place to update.
Longitude coordinate of the Place.
Organization ID this Place belongs to.
Business color as 6-character hex code without '#' (e.g., 'FF5733' for red-orange, used in NearBee).
Business icon URL (used in NearBee).
Business cover URL (used in NearBee).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_UPDATE_QR_CODEUpdate an existing QR Code by its ID. Modify QR Code properties like name, design attributes, tags, and content. Returns the complete updated QR Code object. Important: When updating qr_type, you must also provide the corresponding content: - For static QR codes (qr_type=1): Include fields_data with qr_type and content (e.g., url) - For dynamic QR codes (qr_type=2): Include campaign with content_type and custom_url
Input parameters
Metadata associated with the QR Code
New name for the QR Code
List of tag IDs to associate with the QR Code
ID of the place where the QR Code is deployed
QR type: 1=Static, 2=Dynamic. If provided, must include fields_data (for static) or campaign (for dynamic).
Campaign configuration for dynamic QR Codes. Required when qr_type=2. Example: {'content_type': 0, 'custom_url': 'https://example.com'}
ID of the QR Code to update
Design attributes for the QR Code (colors, logos, etc.)
Fields data for static QR Codes. Required when qr_type=1. Example: {'qr_type': 1, 'url': 'https://example.com'}
ID of the organization the QR Code belongs to
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_UPDATE_TAGTool to update an existing tag by its ID. Use when you need to modify a tag's name or color after confirming its ID via list_tags.
Input parameters
New name for the tag.
Hex color code for the tag, e.g., '#ff0000'.
Unique identifier of the tag to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BEACONSTAC_UPDATE_USERTool to update an existing User. Use when you need to modify profile details or organization of a User by their ID.
Input parameters
Unique identifier of the User to update
New last name; leave unset to retain existing
New first name; leave unset to retain existing
Organization ID to assign; leave unset to retain existing
URL to the User's profile picture; leave unset to retain existing
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 55 agents privately built on Nagent that already use Beaconstac.
Build on Nagent
Connect Beaconstac to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Beaconstac, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Beaconstac is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Beaconstac is connected, you configure its 21 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Beaconstac steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Beaconstac event fires, the agent kicks off automatically.
Every Beaconstac action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Beaconstac ships with 21 pre-built marketing actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Beaconstac together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Beaconstac-based workflows tailored to your business.