POST
/
integrations
/
{integration_id}
/
connection-templates

Path Parameters

integration_id
string
required

Body

application/json

CreateHubConnectionTemplate defines the request body for creating a new Hub Connector

authSchemeConfig
object
required

AuthSchemeConfig defines how a Connector implements the AuthScheme in order to fulfil its authentication requirements. This is purely the configuration and not the actual credential which is used to authenticate. The credential uses this configuration to determine how to authenticate.

authSchemeConfig.id
string
required

ID is the unique identifier of the AuthSchemeConfig, this is generated by the client and only requires to be unique amongst the elements of the array in which is it contained.

authSchemeConfig.description
string
required

Description enables users to distinguish multiple configurations which use the same schemeType.

authSchemeConfig.schemeType
string
required
Allowed value: "none"
authSchemeConfig.validationMessages
object[]

ValidationMessages is a list of messages which are generated when the AuthSchemeConfig is validated. This is typically used to provide feedback to the user when they are creating or updating the AuthSchemeConfig.

This field will be ignored if sent to the API.

connectorId
string
required

ConnectorID is the unique identifier of the Connector that the Hub Connector is wrapping.

Response

200 - application/json

A Hub Connection Template is a lightweight wrapper around a Connector from Connect API, but includes additional information to make embedding the integration simpler.

Versori-users do not need to establish connections in an integration. These are connected to by end-users when they activate the integration from the embedded integration hub.

id
string
required

ID is the unique identifier of the Hub Connection Template.

connectorId
string
required

ConnectorID is the unique identifier of the Connector.

imageUrl
string
required

ImageURL is a URL to an image/icon that represents the connector. This image is used within the integration tile displayed in the embedded UI.

name
string
required

name denotes the name of the Connector that the template is wrapping.

isUsed
boolean
required

IsUsed indicates that this connection template is in use by the hub.

isPrimary
boolean
required

IsPrimary indicates that this is the primary connections on the hub.

authSchemeConfig
object
required

AuthSchemeConfig defines how a Connector implements the AuthScheme in order to fulfil its authentication requirements. This is purely the configuration and not the actual credential which is used to authenticate. The credential uses this configuration to determine how to authenticate.

authSchemeConfig.id
string
required

ID is the unique identifier of the AuthSchemeConfig, this is generated by the client and only requires to be unique amongst the elements of the array in which is it contained.

authSchemeConfig.description
string
required

Description enables users to distinguish multiple configurations which use the same schemeType.

authSchemeConfig.schemeType
string
required
Allowed value: "none"
authSchemeConfig.validationMessages
object[]

ValidationMessages is a list of messages which are generated when the AuthSchemeConfig is validated. This is typically used to provide feedback to the user when they are creating or updating the AuthSchemeConfig.

This field will be ignored if sent to the API.