Activate Integration
ActivateIntegration activates an Integration for an End User. This is the final step in the activation process and will create the necessary connections and configurations to allow the Integration to run.
This endpoint can either reference existing connections or create new ones. Once these connections are resolved/created, if there are any missing connections to what the integration requires, an error will be returned.
Body
ActivationCreate is the request payload to activate an Integration for End User
UserID references the user to activate the integration for, this may be their Versori identifier or their
external identifier, indicated by the userIdType
field.
IntegrationID references the Integration that the activation is for.
Connections is a list of Activation Connections to create for this Activation. Each Activation Connection can either reference an existing underlying Connection, or a new Connection can be created.
TemplateID is a reference to a Connection Template which this Activation Connection is binding to.
ID is the unique identifier of an existing Connection.
Dynamic variables can be used on an integration at run time. The user specifies the value of these variables when activating an integration. When an integration is created, the name and types of these variables can be defined.
Response
ID is the Versori identifier for the user. Most APIs will not use this field but instead reference users by their externalId.
ExternalID is the identifier for the user as determined by the organisation. This typically should be the same as the user's ID on the Primary Connector for the Hub. Regardless of the value, it must be unique within the Hub.
DisplayName is an optional human-readable name for the user. If not set, the default is an empty string.
The hub ID to which the user belongs to.
PrimaryConnection is the connection that the user will use to authenticate to the primary connector.
CreatedAt is the time the user was created.
UpdatedAt is the time the user was last updated.
EndUserIntegration represents an integration that is available to an end user.
This object is only a summary of the integration and does not contain all the information to enable the user to activate it. The GetEmbeddedIntegration endpoint should be used to retrieve the full integration details.
Name is a short name for the integration, this is typically the name of the Connector being integrated to.
ImageURL is a URL to an image/icon that represents the integration. This image is used within the integration tile displayed in the embedded UI.
Description can be used to provide a longer description of the integration. This can be shown to end users in the embedded integration hub UI.
VariablesSchema is the JSON schema for the variables defined for this integration.
IsDeployed indicates whether the integration is deployed and available to end users. If not deployed, the integration cannot be activated.
IsActivated indicates whether the integration is activated for the end user. If the integration is not activated, the user can activate it from the embedded integration hub.