useHotglue React hook reference
useHotglue
is the primary way of using the @hotglue/widget
package outside of the inline Connections
component. Use this to launch the widget and access utility functions.
HotglueConfig
provider as a higher order component in your React app. For example, in index.js
:
useHotglue
hook anywhere, as shown below:
useHotglue
hook.
HotGlue.openWidget(user id, options)
Name | Type | Description |
---|---|---|
user id | string | ID of current user of your application. |
options | objects | option objects |
HotGlue.link(user id, flow id, source, preloaded, options)
Name | Type | Description |
---|---|---|
user id | string | ID of current user of your application. |
flow id | string | ID of flow you wish to connect. Every flow in hotglue has an ID which can be found from the admin panel or API. source |
source | string | ID of source you wish to connect – typically just the name of the source in lowercase. Full catalog is accessible via API. Ex. salesforce |
preloaded | boolean | Mark this flag as true if you used the HotGlue.preload function to improve load time. Defaults to false |
options | object | Object containing options to configure the form: json { "helperText": "Need help finding credentials? [Read the docs](https://docs.hotglue.xyz)" } |
source
is not linked, this will open a popup window for user to login
If specified source
is linked, this will open the hotglue widget under specified flow so user can manage the source.
HotGlue.reconnect(user id, flow id, entity id, options)
Name | Type | Description |
---|---|---|
user id | string | ID of current user of your application. |
flow id | string | ID of flow you wish to reconnect. Every flow in hotglue has an ID which can be found from the admin panel or API. source |
entity id | string | ID of source or target you wish to connect – typically just the name of the source in lowercase. Full catalog is accessible via API. Ex. salesforce |
options | object | Object containing options to configure the form: json { "isTarget": false } |
isTarget
parameter to the options
object.
HotGlue.disconnect(user id, flow id, entity id, options)
Name | Type | Description |
---|---|---|
user id | string | ID of current user of your application. |
flow id | string | ID of flow you wish to disconnect. Every flow in hotglue has an ID which can be found from the admin panel or API. |
source | ||
entity id | string | ID of source or target you wish to disconnect – typically just the name of the source in lowercase. Full catalog is accessible via API. Ex. salesforce |
options | object | Object containing options to configure the form: json { "isTarget": false } |
isTarget
parameter to the options
object if disconnecting a linked target.
HotGlue.setListener(listener)
Name | Type | Description |
---|---|---|
listener | object | Object containing all listeners. See list of available events below. ex. {onSourceLinked: (source, flow) => console.log(JSON.stringify(source))} |
HotGlue.createJob(flowId, tenantId, startDate)
Name | Type | Required | Description |
---|---|---|---|
flowId | string | Yes | ID of flow |
tenantId | string | Yes | ID of user |
startDate | string (ISO date) | No | Optional. Used to override start date of the job. ex: 2022-10-16T00:00:00Z |