Connectors

A connector is a link between Stitch It and a third-party service that Stitch It manages on your behalf.

You can set up connectors without being in a workspace; these connectors become global. You can then associate global connectors to multiple workspaces (creating API connections) and apply different configurations for different workspaces.

Available Stitch It Connectors

Stitch It is equipped with connectors for the following apps and services:

Connector	App	Auth Type	Event Listeners
Bitbucket Cloud		OAuth 2.0
Bitbucket On-Premise		OAuth
Confluence Cloud		OAuth 2.0	1
Confluence On-Premise		OAuth
GitHub		OAuth 2.0
GitLab		OAuth 2.0
Google Calendar		OAuth 2.0	2
Google Sheets		OAuth 2.0	2
Jira Cloud		OAuth 2.0
Jira On-Premise	Jira On-Premise	OAuth
	Jira Service Management On-Premise
	Jira Service Management On-Premise Assets
	Tempo Timesheets On-Premise
	Tempo Planner On-Premise
Jira Service Management Cloud		OAuth 2.0	3
Jira Service Management Cloud Assets		Basic (API Token)
Microsoft		OAuth 2.0
monday.com		OAuth 2.0
ServiceNow		OAuth 2.0
Slack		App credentials
Tempo Cloud		OAuth 2.0

¹ Confluence Cloud officially does not support webhooks. As a workaround, you should be able to use a third-party add-on to register a webhook using the generic event listener in Stitch It. Alternatively you can also use ScriptRunner for Confluence Cloud to setup event listener in Confluence and in turn call a Generic Event Listener in Stitch It whenever the event gets fired. Here is an example code how you would go about writing a Groovy script in ScriptRunner that in turn calls a Generic Event Listener HTTP endpoint in Stitch It, this example demonstrates how to listen to "Label Added" event by extracting couple of event properties and then send them to Stitch It as part of HTTP body:

groovy
def pageTitle = labeled.asType(Map).title
def pageId = labeled.asType(Map).id
def labelTitle = label.asType(Map).title

logger.info("Page Title: ${pageTitle}")
logger.info("Page ID: ${pageId}")
logger.info("Label Title: ${labelTitle}")

def response = post("GENERIC_HTTP_ENDPOINT_URL")
	.body(
		confPageTitle: pageTitle,
		confPageId: pageId,
		labelTitle: labelTitle)
	.asObject(Map)

² As a workaround, you can write a Google Apps Script that triggers for events you are interested in and, in turn, calls the generic event listener to listen for events on the Stitch It side.

³ Reuses base Jira event types for the most part.

Generic API Connector

There's also a generic API connector and generic event listener you can use to connect and listen to events from unlisted apps and services.

You can also use basic/fixed authentication for most services instead of using OAuth. To use fixed authentication, create a generic API connection and either construct the Managed API manually for the generic API connection or use the Fetch API directly.

Creating a Connector

1. Click Connectors on the left side of the page.
   The Connectors view opens in the app.
2. Click Create New.
   The Select App for Connector screen appears.
3. Select and click one of the connector options.
   The Manage Connector wizard for the app appears. 
4. Follow the instructions in the wizard to create and set up the connector.

Deleting a Connector

To delete a connector, click the ellipsis icon, then Delete.