Beaconstac | Composio Docs

Overview

SLUG: BEACONSTAC

Description

Beaconstac provides a platform for creating and managing QR codes and beacons, enabling businesses to engage customers through proximity marketing and track analytics.

Authentication Details

API Key

generic_api_key

stringRequired

Connecting to Beaconstac

Create an auth config

Use the dashboard to create an auth config for the Beaconstac toolkit. This allows you to connect multiple Beaconstac accounts to Composio for agents to use.

Select App

Navigate to the Beaconstac toolkit page and click “Setup Integration”.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 from composio.types import auth_scheme
3 
4 # Replace these with your actual values
5 beaconstac_auth_config_id = "ac_YOUR_BEACONSTAC_CONFIG_ID" # Auth config ID created above
6 user_id = "0000-0000-0000"  # UUID from database/app
7 
8 composio = Composio()
9 
10 def authenticate_toolkit(user_id: str, auth_config_id: str):
11     # Replace this with a method to retrieve an API key from the user.
12     # Or supply your own.
13     user_api_key = input("[!] Enter API key")
14 
15     connection_request = composio.connected_accounts.initiate(
16         user_id=user_id,
17         auth_config_id=auth_config_id,
18         config={"auth_scheme": "API_KEY", "val": user_api_key}
19     )
20 
21     # API Key authentication is immediate - no redirect needed
22     print(f"Successfully connected Beaconstac for user {user_id}")
23     print(f"Connection status: {connection_request.status}")
24     
25     return connection_request.id
26 
27 
28 connection_id = authenticate_toolkit(user_id, beaconstac_auth_config_id)
29 
30 # You can verify the connection using:
31 connected_account = composio.connected_accounts.get(connection_id)
32 print(f"Connected account: {connected_account}")

Tools

Executing tools

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["BEACONSTAC"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

BEACONSTAC_CREATE_PLACE

Tool Name: Create Place

Description

Tool to create a new place for location-based assets. use when you need to register a new physical place under an organization.

Action Parameters

address

stringRequired

latitude

stringRequired

longitude

stringRequired

name

stringRequired

organization

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BEACONSTAC_CREATE_QR_TEMPLATE

Tool Name: Create QR Template

Description

Tool to create a new qr code template. use when you need reusable design presets for qr codes.

Action Parameters

backgroundColor

backgroundImage

colorDark

colorLight

dataPattern

string

default

boolean

dotScale

number

eyeBallColor

eyeBallShape

string

eyeFrameColor

eyeFrameShape

string

frameColor

frameStyle

string

frameText

string

frameTextColor

gradientType

string

logoImage

logoScale

number

margin

integer

BEACONSTAC_CREATE_TAG

Tool Name: Create Tag

Description

Tool to create a new tag for organizing qr codes and other objects. use when you need to categorize qr codes under a specific organization.

Action Parameters

name

stringRequired

organization

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BEACONSTAC_CREATE_USER

Tool Name: Create User

Description

Tool to create a new user. use when onboarding a new user under your organization (reseller plan and above).

Action Parameters

billing_email

string

customer_plan

stringRequired

string

first_name

string

last_name

string

organization

integerRequired

password

string

profile_picture

string

username

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BEACONSTAC_DELETE_QR_CODE

Tool Name: Delete QR Code

Description

Tool to delete a qr code by its id. use when you need to remove an existing qr code after validation.

Action Parameters

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BEACONSTAC_DELETE_QR_TEMPLATE

Tool Name: Delete QR Code Template

Description

Tool 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.

Action Parameters

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BEACONSTAC_DELETE_TAG

Tool Name: Delete Tag

Description

Tool to delete a tag by its id. use when you need to remove an existing tag after validation.

Action Parameters

tag_id

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BEACONSTAC_LIST_BULK_QR_CODES

Tool Name: List Bulk QR Code Collections

Description

Tool to list bulk qr code collections. use when you need to filter, search, or order your bulk qr code collections.

Action Parameters

name__icontains

string

ordering

string

page

integerDefaults to 1

page_size

integerDefaults to 10

qr_data_type

integer

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

BEACONSTAC_LIST_ORGANIZATIONS

Tool Name: List Organizations

Description

Tool to list organizations. use when you need to fetch all organizations accessible to the authenticated account.

Action Parameters

Action Response

data

arrayRequired

error

string

successful

booleanRequired

BEACONSTAC_LIST_PLACES

Tool Name: List Places

Description

Tool to list your places. use when you need to browse or search your account's places with filtering and ordering.

Action Parameters

name

string

name__icontains

string

ordering

string

page

integerDefaults to 1

page_size

integerDefaults to 10

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

BEACONSTAC_LIST_QR_TEMPLATES

Tool Name: List QR Templates

Description

Tool to list all qr code templates in your account. use when you need to filter and paginate templates.

Action Parameters

name__icontains

string

organization

integerRequired

page

integer

page_size

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

BEACONSTAC_LIST_TAGS

Tool Name: List Tags

Description

Tool to list all tags with optional filtering and pagination. use when you need to browse or search tags in your account.

Action Parameters

name__icontains

string

ordering

string

page

integerDefaults to 1

page_size

integerDefaults to 10

Action Response

data

objectRequired

error

string

successful

booleanRequired

BEACONSTAC_LIST_USERS

Tool Name: List Users

Description

Tool to list all users with optional filtering, searching, ordering, and pagination. use when you need to retrieve user records across your organization.

Action Parameters

customer_plan

string

date_joined__gt

string

date_joined__gte

string

date_joined__lt

string

date_joined__lte

string

email__exact

string

email__icontains

string

first_name__exact

string

first_name__icontains

string

last_name__exact

string

last_name__icontains

string

ordering

string

organization

integer

page

integerDefaults to 1

page_size

integerDefaults to 10

string

subscription_state

string

username__exact

string

username__icontains

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

BEACONSTAC_PERIOD_OVERVIEW

Tool Name: Get Period Overview

Description

Tool to get period overview analytics for products including counts, impressions, and conversion percentage. use after specifying the product type and time interval.

Action Parameters

from_timestamp

integerRequired

organization

integerRequired

product_type

stringRequired

to_timestamp

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BEACONSTAC_PRODUCT_OVERVIEW

Tool Name: Get Product Overview

Description

Tool 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.

Action Parameters

from_timestamp

integerRequired

organization

integerRequired

product_type

stringRequired

to_timestamp

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BEACONSTAC_RETRIEVE_QR_CODE

Tool Name: Retrieve QR Code

Description

Tool to retrieve details of a specific qr code by its id. use when you need to fetch or verify qr code properties after creation or update.

Action Parameters

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BEACONSTAC_RETRIEVE_USER

Tool Name: Retrieve User

Description

Tool to retrieve the details of an existing user by id. use when you need to fetch a user's profile after confirming its existence.

Action Parameters

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BEACONSTAC_UPDATE_PLACE

Tool Name: Update Place

Description

Tool to update the specified place by id. use after retrieving the place to modify its details, such as name, address, or coordinates.

Action Parameters

address

string

business_color

string

business_cover_url

string

business_icon_url

string

latitude

number

longitude

number

name

stringRequired

organization

integerRequired

place_id

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BEACONSTAC_UPDATE_QR_CODE

Tool Name: Update QR Code

Description

Tool to update an existing qr code by its id. use when you need to modify qr code attributes; only provided fields are changed.

Action Parameters

attributes

object

campaign

object

fields_data

object

BEACONSTAC_UPDATE_TAG

Tool Name: Update Tag

Description

Tool 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.

Action Parameters

color

string

name

string

tag_id

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

BEACONSTAC_UPDATE_USER

Tool Name: Update User

Description

Tool to update an existing user. use when you need to modify profile details or organization of a user by their id.

Action Parameters

first_name

string

last_name

string

organization

integer

profile_picture

string

user_id

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired