Connectors

A connector is a link between ScriptRunner Connect and a third-party service that ScriptRunner Connect 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 ScriptRunner Connect Connectors

ScriptRunner Connect 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 ScriptRunner Connect. Alternatively, you can also use ScriptRunner for Confluence Cloud to set up an event listener in Confluence and call a generic event listener in ScriptRunner Connect whenever the event gets fired.

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

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

⁴ Currently, 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.