iObeya

  • Reference

Connect your favorite apps with iObeya, automate information flow between teams, and create a single source of truth for better decision-making thanks to iObeya.

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 iObeya Integrations
URL https://www.iobeya.com/
Email integrations-support@iobeya.com
Connector Metadata
Publisher iObeya
Website https://www.iobeya.com
Privacy policy https://www.iobeya.com/privacy-policy/
Categories Collaboration;Productivity

iObeya boosts the agility of your organization by bringing teams together on a single visual collaboration platform ready to support all your Visual Management practices. Connecting iObeya with your favorites productivity tools helps to improve your visual collaboration while keeping your data synchronized.

Prerequisites

You will need the following to use this connector:

  • An iObeya platform with an Enterprise subscription plan. If you don't, you can use our Request a Demo form to start the discussion to get access to iObeya.
  • A valid OAuth application endpoint for external clients declared via your iObeya platform administration interface (see below)

How to get credentials

For authentication, you need to use an API token. To create a token, follow these steps:

  • As a platform admin user connected to the iObeya administration interface, click on the SETTINGS > API
  • Create a new OAuth application endpoint by clicking on the “Add OAuth application” button
  • Configure the OAuth application
  • Once validated, copy the identifier value generated by iObeya, it's the ClientId required for the authentication and the secret value as Client Secret.

Get started with your connector

With this connector, you can enrich your iObeya experience. Here a few exemple of scenario that you can create:

  • Create automaticaly a project plan using data from an Excel spreadsheet
  • Import your KPIs from various data sources into your QCD boards and update them automaticaly
  • Create cards in iObeya using data from an external system like ServiceNow, SAP or Planner.

Known Issues and Limitations

Please find below a non-exhaustive list of several known limitations:

  • The connector work only with Cloud iObeya platforms. We will provide support with iObeya On-prem platforms later on.
  • The dropdown list to select a board return the first 200 iObeya boards you have access to.
  • You must use the userId of a user when you want to assign a card to someone (not the email address, nor the username).

FAQ

Don’t hesitate to contact us if you have any question, or you want to share your feedback regarding our connector via integrations-support@iobeya.com.

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
iObeya Server string Prefix of your iObeya Server, ex : 'demo' for demo.iobeya.com True
Client ID string Your API Client ID True
Client Secret string Your API Client Secret True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Compute QCD Letter's Indicator

Compute a QCD Letter's Indicator object
Create a room

Create a room in a specific domain
Create Card

Create a new Card
List Cards Activity

List Cards Activity between two dates
List of Boards

Retrieve list of Boards
List of Rooms

Retrieve list of Rooms
Update asset of a board image

Update an asset of board image on a board
Update Gauge

Update an gauge
Update QCD Indicators

Bulk Update of QCD Indicators Values

Compute QCD Letter's Indicator

Operation ID:
ComputeQCDIndicator

Compute a QCD Letter's Indicator object

Parameters

Name Key Required Type Description
Letter Name
 letterName True string

QCD Letter's name
Indicator Name
 indicatorName True string

QCD Letter's indicator name
Indicator Value
 wedgeValue True number

QCD Letter's indicator value or KPI
Wedge Index
 wedgeNumber True integer

Wedge Index Position in the circle
Wedge Ring
 wedgeRing True string

Wedge Ring (inner, middle, outer)
Period expected (Date)
 period date

Period as date of the indicator (use to control, example 10/12/2022)

Returns

response
object

Create a room

Operation ID:
CreateRooms

Create a room in a specific domain

Parameters

Name Key Required Type Description
Name
 name True string

Name of the room
Domain's name
 domainName True string

Name of the domain where create the room
Maximum Boards
 maximumBoards integer

Number of maximum board can be created
Maximum Users
 maximumUsers integer

Number of maximum users for the room
Description
 description string

Description of the room
Category
 category string

Category of the room
Administrator UserID
 administrator string

ID of the administrator

Returns

Name Path Type Description
Self Room URL
 self string

Url of the room
Kind
 kind string

Kind of room
Room ID
 id string

Id of the room
Domain ID
 domainId string

Id of the domain

Create Card

Operation ID:
CreateCard

Create a new Card

Parameters

Name Key Required Type Description
Type Card
 Type Card True string

Type of card
dynamicSchema
 dynamicSchema dynamic

Returns

Name Path Type Description
self
 self string

Url of the card
kind
 kind string

Kind of card
status
 status integer

Status Code
id
 id string

Id of the card

List Cards Activity

Operation ID:
ListCardsActivity

List Cards Activity between two dates

Parameters

Name Key Required Type Description
Board
 boardId True string

Planning board
From Date
 from string

ISO 8601 format: YYYY-MM-DD
To Date
 to string

ISO 8601 format: YYYY-MM-DD
Page
 page True integer

Page number
Page Size
 size integer

Number of items to retrieve

Returns

Name Path Type Description
self
 self string

Url of the collection
kind
 kind string

Collection
totalCount
 totalCount integer

Total count of elements
previous
 previous string

Url of the previous page
next
 next string

Url of the next page
data
 data array of object

Collection of activity cards
self
 data.self string

Url of the card
kind
 data.kind string

Kind of card
id
 data.id string

Id of the card
title
 data.title string

Card's title
startDate
 data.startDate string

Start date of the activity
endDate
 data.endDate string

End date of the activity

List of Boards

Operation ID:
ListBoards

Retrieve list of Boards

Parameters

Name Key Required Type Description
Search Criteria
 search string

Search by board's name
Sort Direction
 sortDirection string

Choose the sort direction

Returns

Name Path Type Description
self
 self string

Url of the collection
kind
 kind string

Kind of collection
totalCount
 totalCount integer

Total count of elements
next
 next string

Url of the next page
nextLink
 nextLink string

Url of the next page
data
 data array of object

Collection of boards
self
 data.self string

Url of the board
kind
 data.kind string

Kind of board
type
 data.type string

Board's type
id
 data.id string

Id of the board
name
 data.name string

Name of the board
url
 data.url string

Direct url to the board
self
 data.room.self string

Url of the board's room
kind
 data.room.kind string

Kind of room
id
 data.room.id string

Id of the board's room
name
 data.room.name string

Name of the board's room

List of Rooms

Operation ID:
ListRooms

Retrieve list of Rooms

Returns

Name Path Type Description
Self Collection URL
 self string

Url of the room collection
Kind
 kind string

Kind of collection
Total Element Count
 totalCount integer

Total count of elements
data
 data array of object

Collection of rooms
Self Room URL
 data.self string

Url of the room
Kind
 data.kind string

Kind of room
Room ID
 data.id string

Id of the room
Room Name
 data.name string

Name of the room

Update asset of a board image

Operation ID:
UpdateAssetBoardImage

Update an asset of board image on a board

Parameters

Name Key Required Type Description
Board Image ID
 boardImageId True string

The board image ID can be found with Copy Technical ID in the properties of the iObeya image.
File to upload
 file True file

File to upload
Content Type
 file/content-type True string

Content type of the file to updload

Returns

response
object

Update Gauge

Operation ID:
UpdateGauge

Update an gauge

Parameters

Name Key Required Type Description
Gauge ID
 gaugeId True string

The gauge ID can be found with Copy Technical ID in the properties of the iObeya gauge.
Value
 value True number

Value of the gauge
Title
 title string

Title of the gauge

Returns

response
object

Update QCD Indicators

Operation ID:
UpdateQCDIndicatorsValue

Bulk Update of QCD Indicators Values

Parameters

Name Key Required Type Description
Board ID
 boardId True string

ID of the board where you want place the card
Indicators
 Indicators object

Returns

response
object

Definitions

object

This is the type 'object'.