Set up the Calendly spoke
Set up an outbound integration between your ServiceNow instance and the Calendly APIs by creating an OAuth application in Calendly and a connection and credential record on your ServiceNow instance.
Before you begin
- Request an Integration Hub subscription.
- Activate the Calendly spoke.
- Ensure that you have a Calendly account.
- Role required: admin.
About this task
After setting the outbound integration, you can set up a flow on the Workflow Studio using the Calendly spoke actions and automate tasks in Calendly. For example, you can set up a flow that cancels an event on Calendly. The connection and credentials record contains the credentials to establish a connection with the Calendly APIs before you automate the tasks on Calendly. The OAuth application authenticates the connection request from your ServiceNow instance.
Set up an OAuth application in Calendly
Set up an OAuth application that authenticates requests from your ServiceNow instance.
Before you begin
Role required: Calendly organization owner or admin
Procedure
Log in to the developer portal.
Select + Create new app.
Fill the form.
Field Description Mandatory? Name of app Custom name of the OAuth application. Yes Kind of app Type of application the OAuth app will support. Select Web. Yes Environment type Type of environment in which the OAuth app will be deployed. Yes Redirect URI The URL of your ServiceNow instance. Yes Select Save & Continue.
The client ID and client secret that you use in the connection and credentials record are generated.
To copy the client ID, select Copy.
To copy the client secret, select Copy.
Calendly OAuth details.
Select Return to My Apps.
The OAuth app is created.
OAuth app created.
Create a connection and credential record
Create a connection and credential record that contains the details required to access the Calendly APIs.
Before you begin
Role required: ServiceNow admin
Procedure
Log in to your ServiceNow instance.
Navigate to Process Automation > Workflow Studio.
Select Integrations.
In the Search all connections field, enter
Calendly.
Enter Calendly in the search field.
The **Outbound** tab is enabled by default. Confirm that the **Outbound** tab is enabled already.
- On the Calendly card, select View Details.
View Details button on Calendly card.
- Select Configure.
Configure button for Calendly connection.
- Fill the form.
| Field | Description |
|---|---|
| Connection Name | Name of the connection.Note: The first and default connection name is read-only. To provide a custom name, create a connection by selecting Add Connection. |
| Connection URL | Base URL for the Calendly Application Programming Interface \(API\). This field is automatically set to `https://api.calendly.com`. |
| OAuth Client ID | Client ID that you had generated on the Calendly developers portal. To learn how to generate a client ID, see Set up an OAuth application in Calendly. |
| OAuth Client Secret | Client ID that you had generated on the Calendly developers portal. To learn how to generate a client secret, see Set up an OAuth application in Calendly. |
| OAuth Redirect URL | URL of the OAuth provider that users are redirected to after authentication. This field populates automatically based on your instance name. |
Select Configure and Get OAuth Token.
Select Connect to Calendly.
The OAuth refresh token becomes available.
Connection and credential record created for Calendly.
To get the OAuth token, select Get OAuth Token.
Important: To get the OAuth token, log in to https://calendly.com/app/login with your licensed account credentials.