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	Teams	OAuth 2.0
monday.com		OAuth 2.0
Opsgenie		Basic (API Token)
Salesforce		OAuth 2.0
ServiceNow		OAuth 2.0
Slack		App credentials
Statuspage		Basic (API Token)
Tempo Cloud		OAuth 2.0
Trello		Basic (API Token)	4
Zoom		App credentials

¹ 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 set up an event listener in Confluence and call a Generic Event Listener in Stitch It whenever the event gets fired.

Here is an example of how you would go about writing a Groovy script in ScriptRunner that calls a Generic Event Listener HTTP endpoint in Stitch It. This example demonstrates how to listen to the Label Added event by extracting a couple of event properties and then sending them to Stitch It as part of the 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)

² Google products don't support webhooks, but as a workaround, you can write a Google Apps Script that triggers for events you are interested in, which, in turn, calls the generic event listener to listen for events on the Stitch It side.

³ For the most part, Jira Service Management Cloud reuses base Jira event types.

⁴ At this time, Trello webhooks are not supported, but you can use Trello's API to set up webhooks. Here is a template that demonstrates this use case.

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

Making new connectors is easy. Follow these steps!

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 one of the connector options.
   The Manage Connector dialog appears.
   
   
4. Enter a name for the connector, then click Authorize.
   
   The authorization wizard appears. (Authorization steps vary from app to app.)
   
   
5. Complete the authorization steps in the wizard to authorize the connector.
   This includes a permissions prompt that, when accepted, allows Stitch It to work with your selected app.
   
   Here's an example from the Google Calendar authorization, for which you should click Allow:
   
   
   
6. Once the authorization steps are complete, click Save on the Manage Connector dialog.
   
   
   A success message appears in the app, and your new connector is created.
   

Deleting a Connector

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