Ubiqod by Skiply v2 (Preview)

Ubiqod provides a simple and powerful platform to connect your Skiply IoT buttons and Qods to third party platforms. This connector triggers a flow every time data is sent by any of the QR codes.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following:      -   Azure Government regions      -   Azure China regions      -   US Department of Defense (DoD)
Power Automate	Premium	All Power Automate regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)
Power Apps	Premium	All Power Apps regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)

Contact
Name	Skiply Support
URL	https://www.skiply.eu/docs/?utm_source=PowerAutomate
Email	support@ubiqod.com

Connector Metadata
Publisher	Skiply
Website	https://app.ubiqod.com/
Privacy policy	https://www.skiply.eu/en/general-terms-and-conditions/
Categories	IT Operations;Internet of Things

Ubiqod by Skiply v2

Ubiqod provides a simple and powerful platform to connect your Skiply IoT buttons and Qods to third-party platforms. This connector triggers a flow every time data is sent by any of the trackers.

Publisher: Skiply

Skiply is responsible for the development and maintenance of the Ubiqod connector.

Prerequisites

To use this connector, you will need:

• A Microsoft Power Apps or Power Automate plan.
• An active Ubiqod account.
• Sufficient credits in your Ubiqod account.

Supported Operations

This section outlines the various operations supported by the Ubiqod by Skiply connector, categorized by functionality:

Badge Operations

• Create Badge List: Create a new list of badges.
• Get Badge List: Retrieve details of a specific badge list by its ID.
• Update Badge List: Update details of an existing badge list.
• Delete Badge List: Remove a badge list using its ID.

Pin Code Operations

• Create Pin Code List: Establish a new list of pin codes.
• Get Pin Code List: Fetch a specific pin code list using its ID.
• Update Pin Code List: Modify an existing pin code list.
• Delete Pin Code List: Erase a pin code list by ID.

Site Operations

• Create Site: Add a new site with specific geolocation details.
• Get Site: Obtain details of a site by its ID.
• Update Site: Update the details of an existing site.
• Delete Site: Remove a site using its ID.

Tracker Operations

• Create Tracker: Configure a new tracker for deployment.
• Get Tracker: Retrieve details of a tracker using its identifier.
• Update Tracker: Modify the settings or details of an existing tracker.
• Delete Tracker: Remove a tracker from the system using its identifier.

Trigger Operation

• Receive Data From Trackers: This trigger operation is initiated when a dispatch event is sent by Ubiqod. It is configured to activate upon receiving data from trackers, facilitating real-time data processing and integration with third-party platforms.

Each of these operations requires specific parameters and offers detailed responses, which are outlined in the API documentation provided by Skiply.

Obtaining Credentials

To obtain your Ubiqod API Key:

1. Log in to your Ubiqod account.
2. Navigate to the "Account" section.
3. Your API Key will be listed there.

Getting Started

Set up the connection

1. Go to the Connection section in Power Automate.
2. Add a New Connection.
3. Search for Ubiqod By Skiply v2 application.
4. Enter your Ubiqod API Key and create the connection.

Set up the flow

1. As a trigger, select the Ubiqod application and the Receive Data From Trackers event.
2. Enter the name of your dispatch, and Ubiqod will automatically create it for you.
3. Add the action(s) of your choice.

Test the connection

• Simulate the real IoT trackers using the Ubiqod simulator. Press the "play" button in the trackers list to start the simulator.

Known Issues and Limitations

No major issues or limitations are currently known for the Ubiqod connector.

Deployment Instructions

Please use these instructions to deploy this connector as custom connector in Microsoft Flow and PowerApps.

Creating a connection

The connector supports the following authentication types:

Default	Parameters for creating connection.	All regions	Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
API Key	securestring	Provide your API Key.	True

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Add new codes to pin code list	Add new codes to an existing pin code list
Adds new badges to badge list	Add new badges to an existing badge list
Create a badge list	Create a new badge list
Create a pin code list	Create a new pin code list
Create a QR Code Tracker (QOD)	Create a new QR Code travker (QOD)
Create a site	Create a new site
Create multiple QR Code Trackers (QOD)	Create QR Code trackers (QOD) in bulk with the same configuration
Create Multiple Sites	Create Multiple New Sites
Delete a badge list	Delete a badge list via its ID
Delete a pin code list	Delete a pin code list via its ID
Delete a QR Code Tracker (QOD)	Delete a tracker via its slug (Scan URL or Serial Number)
Delete a site	Delete a site via its ID
Delete Badges from Badge List	Delete existing badges from an existing badge list
Delete codes from pin code list	Delete existing codes from an existing pin code list
Delete multiple QR Code tracker (QOD)	Delete trackers in bulk via their slug (Scan URL or Serial Number)
Delete Multiple Sites	Delete sites in bulk
Get a tracker data	Get a tracker from its slug (Scan URL or Serial Number)
Get all Badge lists associated with your account	Get all Badge lists associated with your account
Get all interfaces associated with your account	Retrieves a list of all interfaces associated with your account.
Get all PIN code lists associated with your account	Get all PIN code lists associated with your account
Get all sites associated with your account	Get all sites associated with your account
Get all trackers associated with your account	Get all trackers associated with your account
Get pin code list data	Fetch one pin code list by ID
Get site data	Fetch one site by ID
Update a badge list	Update a badge list
Update a pin code list	Update a pin code list
Update a site	Update a site
Update a tracker	Update a tracker
Update codes from a pin code list	Update existing codes from an existing pin code list
Update existing badges from a badge list	Update existing badges from a badge list

Add new codes to pin code list

Operation ID:

AddNewCodesToThePinCodeList

Add new codes to an existing pin code list

Parameters

Name	Key	Required	Type	Description
Adds codes to the specified pin code list	pinCodeListId	True	string	Pin codes to add
Label	label	True	string	Pin Code Label
Code	pin	True	string	Code
External references	additionalProp		string	additionalProp

Returns

Body

PinCodeList

Adds new badges to badge list

Operation ID:

AddNewBadgesToTheBadgeList

Add new badges to an existing badge list

Parameters

Name	Key	Required	Type	Description
Adds new badges to the specified list	badgeListId	True	string	Choose a Badge list ID
Label	label	True	string	Badge Label
Badge ID	pin	True	string	Badge ID

Returns

Body

BadgeList

Create a badge list

Operation ID:

CreateOneBadgeList

Create a new badge list

Parameters

Name	Key	Required	Type	Description
Badge list Label	label	True	string	Badge list Label
Label	label	True	string	badge Label
Badge ID	pin	True	string	Badge ID
External references	additionalProp1		string	additionalProp

Returns

Body

BadgeList

Create a pin code list

Operation ID:

CreateOnePinCodeList

Create a new pin code list

Parameters

Name	Key	Required	Type	Description
Pin code list Label	label	True	string	Pin code list Label
Label	label	True	string	Label
Code	pin	True	string	Code

Returns

Body

PinCodeList

Create a QR Code Tracker (QOD)

Operation ID:

CreateOneQodTracker

Create a new QR Code travker (QOD)

Parameters

Name	Key	Required	Type	Description
Label	label	True	string	Tracker Label
Site	site_id		string	Choose a site
Interface	interface_id		string	Choose an interface
dispatches	dispatches		array of string	dispatches

Returns

Body

Tracker

Create a site

Operation ID:

CreateOneSite

Create a new site

Parameters

Name	Key	Required	Type	Description
Site Label	label	True	string	Site Label
Latitude	latitude	True	float	Latitude
Longitude	longitude	True	float	Longitude
distanceMargin	distanceMargin		integer	Site Geofencing Validation Distance (meters)
additionalProp1	additionalProp1		string	additionalProp1
trackers	trackers		array of string	trackers

Returns

Body

Site

Create multiple QR Code Trackers (QOD)

Operation ID:

CreateQodTrackersInBulkWithTheSameConfiguration

Create QR Code trackers (QOD) in bulk with the same configuration

Parameters

Name	Key	Required	Type	Description
labels	labels		array of string	labels
Site	site_id		string	Choose a site
Interface	interface_id		string	Choose an interface
dispatches	dispatches	True	array of string	dispatches

Returns

response

array of Tracker

Create Multiple Sites

Operation ID:

CreateSitesInBulk

Create Multiple New Sites

Parameters

Name	Key	Required	Type	Description
Site Label	label	True	string	Site Label
Latitude	latitude	True	float	Latitude
Longitude	longitude	True	float	Longitude
Site Geofencing Distance Margin (meters)	distanceMargin		integer	Site Geofencing Distance Margin (meters)
trackers	trackers		array of string	trackers

Returns

response

array of Site

Delete a badge list

Operation ID:

DeleteABadgeListViaItsId

Delete a badge list via its ID

Parameters

Name	Key	Required	Type	Description
Deletes a badge list by its ID	badgeListId	True	string	Enter a Badge list ID

Returns

Name	Path	Type	Description
message	message	string	message

Delete a pin code list

Operation ID:

DeleteAPinCodeListViaItsId

Delete a pin code list via its ID

Parameters

Name	Key	Required	Type	Description
Deletes a pin code list by its ID	pinCodeListId	True	string	Choose a Pin code list

Returns

Name	Path	Type	Description
message	message	string	message

Delete a QR Code Tracker (QOD)

Operation ID:

DeleteATrackerViaItsSlug

Delete a tracker via its slug (Scan URL or Serial Number)

Parameters

Name	Key	Required	Type	Description
Deletes a tracker by its slug	trackerSlug	True	string	Tracker Slug

Returns

Name	Path	Type	Description
message	message	string	message

Delete a site

Operation ID:

DeleteASiteViaItsId

Delete a site via its ID

Parameters

Name	Key	Required	Type	Description
Deletes a site by its ID	siteId	True	string	Choose a site

Returns

Name	Path	Type	Description
message	message	string	message

Delete Badges from Badge List

Operation ID:

DeleteCodesFromABadgeList

Delete existing badges from an existing badge list

Parameters

Name	Key	Required	Type	Description
Deletes codes from the specified badge list	badgeListId	True	string	Choose a Badge list ID.
Badge IDs to delete	Badge IDs to delete	True	array of string

Returns

Body

BadgeList

Delete codes from pin code list

Operation ID:

DeleteCodesFromAPinCodeList

Delete existing codes from an existing pin code list

Parameters

Name	Key	Required	Type	Description
Deletes codes from the specified pin code list	pinCodeListId	True	string	Choose a Pin code list
Pin codes to delete	Pin codes to delete	True	array of string

Returns

Body

PinCodeList

Delete multiple QR Code tracker (QOD)

Operation ID:

DeleteTrackersInBulkViaTheirSlug

Delete trackers in bulk via their slug (Scan URL or Serial Number)

Parameters

Name	Key	Required	Type	Description
Trackers List	Trackers List	True	array of string

Returns

Name	Path	Type	Description
message	message	string	message

Delete Multiple Sites

Operation ID:

DeleteSitesInBulkViaTheirId

Delete sites in bulk

Parameters

Name	Key	Required	Type	Description
Sites List IDs	Sites List IDs	True	array of string

Returns

Name	Path	Type	Description
message	message	string	message

Get a tracker data

Operation ID:

GetATrackerFromItsSlug

Get a tracker from its slug (Scan URL or Serial Number)

Parameters

Name	Key	Required	Type	Description
Fetches a tracker by its slug	trackerSlug	True	string	Tracker Slug

Returns

Body

Tracker

Get all Badge lists associated with your account

Operation ID:

GetAllBadgeListsAssociatedWithYourAccount

Get all Badge lists associated with your account

Parameters

Name	Key	Required	Type	Description
Items to skip before collecting results. Default is 0.	limit	True	string	The number of items to skip before starting to collect the result set. Default is 0.
The number of items to return. Default is 100.	offset	True	string	The number of items to return. Default is 100.

Returns

List of Badge lists

response

array of BadgeList

Get all interfaces associated with your account

Operation ID:

GetAllInterfaceAssociatedWithYourAccount

Retrieves a list of all interfaces associated with your account.

Returns

response

array of Interface

Get all PIN code lists associated with your account

Operation ID:

GetAllPinCodeListsAssociatedWithYourAccount

Get all PIN code lists associated with your account

Parameters

Name	Key	Required	Type	Description
The number of items to return. Default is 100.	limit	True	string	The number of items to return. Default is 100.
Number of items to skip before collecting results. Default is 0.	offset	True	string	The number of items to skip before starting to collect the result set. Default is 0.

Returns

response

array of PinCodeList

Get all sites associated with your account

Operation ID:

GetAllSitesAssociatedWithYourAccount

Get all sites associated with your account

Parameters

Name	Key	Required	Type	Description
The number of items to return. Default is 100.	limit	True	string	The number of items to return. Default is 100.
Skip items before collecting results. Default is 0.	offset	True	string	The number of items to skip before starting to collect the result set. Default is 0.

Returns

response

array of Site

Get all trackers associated with your account

Operation ID:

GetAllTrackersAssociatedWithYourAccount

Get all trackers associated with your account

Parameters

Name	Key	Required	Type	Description
The number of items to return. Default is 100.	limit	True	string	The number of items to return. Default is 100.
Skip count before collecting results. Default is 0.	offset	True	string	The number of items to skip before starting to collect the result set. Default is 0.

Returns

response

array of Tracker

Get pin code list data

Operation ID:

GetAPinCodeListFromItsId

Fetch one pin code list by ID

Parameters

Name	Key	Required	Type	Description
Fetches a pin code list by its ID	pinCodeListId	True	string	Choose a Pin code list

Returns

Body

PinCodeList

Get site data

Operation ID:

GetASiteFromItsId

Fetch one site by ID

Parameters

Name	Key	Required	Type	Description
Fetches a site by its ID	siteId	True	string	Choose a site

Returns

Body

Site

Update a badge list

Operation ID:

UpdateABadgeList

Update a badge list

Parameters

Name	Key	Required	Type	Description
Updates a badge list by its ID	badgeListId	True	string	Enter a Badge list ID
label	label		string	label

Returns

Body

BadgeList

Update a pin code list

Operation ID:

UpdateAPinCodeList

Update a pin code list

Parameters

Name	Key	Required	Type	Description
Updates a pin code list	pinCodeListId	True	string	Choose a Pin code list
label	label		string	label

Returns

Body

PinCodeList

Update a site

Operation ID:

UpdateASite

Update a site

Parameters

Name	Key	Required	Type	Description
Updates a site by its ID	siteId	True	string	Choose a site
Site Label	label		string	Site Label
Latitude	latitude		float	Latitude
Longitude	longitude		integer	Longitude
Site Geofencing Validation Distance	distanceMargin		float	Site Geofencing Validation Distance
additionalProp	additionalProp		string	additionalProp

Returns

Body

Site

Update a tracker

Operation ID:

UpdateATracker

Update a tracker

Parameters

Name	Key	Required	Type	Description
Updates a tracker by its slug	trackerSlug	True	string	Tracker Slug
Tracker Label	label		string	Tracker Label
Site	site_id		string	Choose a Site
Interface	interface_id		string	Choose an Interface
dispatches	dispatches		array of string	dispatches

Returns

Body

Tracker

Update codes from a pin code list

Operation ID:

UpdateExistingCodesFromAPinCodeList

Update existing codes from an existing pin code list

Parameters

Name	Key	Required	Type	Description
Updates codes from the specified pin code list	pinCodeListId	True	string	Choose a Pin code list
Label	label	True	string	label
Code	pin	True	string	Code
External references	additionalProp		string	additionalProp

Returns

Body

PinCodeList

Update existing badges from a badge list

Operation ID:

UpdateExistingCodesFromABadgeList

Update existing badges from a badge list

Parameters

Name	Key	Required	Type	Description
Updates codes from the specified badge list	badgeListId	True	string	Choose a Badge list ID
Badge Label	label	True	string	label
Badge ID	pin	True	string	Badge ID
External references	additionalProp1		string	additionalProp

Returns

Body

BadgeList

Triggers

Receive Data From Trackers

Trigger when a dispatch event is sent by Ubiqod (receiving data from trackers)

Receive Data From Trackers

Operation ID:

ReceiveDataFromTrackers

Trigger when a dispatch event is sent by Ubiqod (receiving data from trackers)

Parameters

Name	Key	Required	Type	Description
Dispatch Name	hookName		string	hookName
Webhook	dispatchId		string	Choose a hook

Returns

Name	Path	Type	Description
Object Label	data.code.label	string	Label of the object
Reference ID	data.code.reference	string	Reference identifier
External References	data.code.externalReferences	object	A dictionary for external references
Label	data.label	string	label
Photo URL	data.photo	string	photo
Reference	data.reference	string	reference
Interface Type	data.interfaceType	string	interfaceType
Rate	data.rate	integer	rate
Email Address	data.email	string	email
Message Content	data.message	string	message
Press Count	data.pressCount	integer	pressCount
Site ID	site.id	string	id
Site Label	site.label	string	label
Contact List	site.contacts	array of object	contacts
Contact Type	site.contacts.type	string	type
Contact Email	site.contacts.email	string	email
Contact Phone	site.contacts.phone	string	phone
Contact Name	site.contacts.fullName	string	fullName
Site Location	site.location	string	location
Custom Key	site.externalReferences.custom_key	string	custom_key
Account Name	account.name	string	name
Tracker ID	tracker.id	string	id
Tracker Slug	tracker.slug	string	slug
Tracker Type	tracker.type	string	type
Tracker Label	tracker.label	string	label
Tracker Model	tracker.model	string	model
Location	location	string	location
Timestamp	timestamp	string	timestamp
On-Site	ubiqodValidity.onSite	boolean	onSite
Code Validity	ubiqodValidity.codeValid	boolean	codeValid
Scan Token	ubiqodValidity.scanToken	boolean	scanToken
With Photo	ubiqodValidity.withPhoto	boolean	withPhoto
Badge Swiped	ubiqodValidity.badgeSwiped	boolean	badgeSwiped
Code from Cookie	ubiqodValidity.codeFromCookie	boolean	codeFromCookie

Definitions

BadgeList

Name	Path	Type	Description
id	id	uuid
label	label	string
list	list	array of object
label	list.label	string
pin	list.pin	string
externalReferences	list.externalReferences	object

PinCodeList

Name	Path	Type	Description
id	id	uuid
label	label	string
list	list	array of object
label	list.label	string
pin	list.pin	string
externalReferences	list.externalReferences	object

Tracker

Name	Path	Type	Description
id	id	uuid
slug	slug	string
type	type	string
subtype	subtype	string
label	label	string
dispatches	dispatches	array of uuid
interface_id	interface_id	uuid
site_id	site_id	uuid
site_label	site_label	string
site_latitude	site_latitude	number
site_longitude	site_longitude	number
last_seen	last_seen	date-time
last_data	last_data	date-time
sigfox_id	sigfox_id	string
sigfox_pac	sigfox_pac	string
lora_dev_uid	lora_dev_uid	string
lora_app_uid	lora_app_uid	string
lora_app_key	lora_app_key	string
lora_dev_addr	lora_dev_addr	string
lora_nwk_skey	lora_nwk_skey	string
lora_app_skey	lora_app_skey	string
lora_status	lora_status	string

Site

Name	Path	Type	Description
id	id	uuid
label	label	string
street	street	string
zipCode	zipCode	string
city	city	string
state	state	string
country	country	string
distanceMargin	distanceMargin	number
latitude	latitude	number
longitude	longitude	number
externalReferences	externalReferences	object

Interface

Name	Path	Type	Description
id	id	uuid
label	label	string
interactionType	interactionType	string
interactionSubtype	interactionSubtype	string