The Calendly (OAuth) API allows developers to integrate Calendly with their applications, allowing their users to schedule appointments and events directly from the app. With the API, developers can create, read, update, and delete Calendly event types, invitees, and schedule events on behalf of their users.
Example applications that could be built using the Calendly (OAuth) API include:
import { axios } from "@pipedream/platform"
export default defineComponent({
props: {
calendly_v2: {
type: "app",
app: "calendly_v2",
}
},
async run({steps, $}) {
return await axios($, {
url: `https://api.calendly.com/users/me`,
headers: {
Authorization: `Bearer ${this.calendly_v2.$auth.oauth_access_token}`,
},
})
},
})
Calendly (OAuth) uses OAuth authentication. When you connect your Calendly (OAuth) account, Pipedream will open a popup window where you can sign into Calendly (OAuth) and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Calendly (OAuth) API.
Pipedream requests the following authorization scopes when you connect your account:
GET
https://auth.calendly.com/oauth/authorize
?
client_id={{oauth.client_id}}
&
redirect_uri={{oauth.redirect_uri}}
&
state={{oauth.state}}
&
response_type=code
&
scope={{oauth.space_separated_scopes}}
POST
https://auth.calendly.com/oauth/token
content-type: application/x-www-form-urlencoded
accept: application/json
client_id={{oauth.client_id}}
&
client_secret={{oauth.client_secret}}
&
redirect_uri={{oauth.redirect_uri}}
&
grant_type=authorization_code
&
code={{oauth.code}}
POST
https://auth.calendly.com/oauth/token
content-type: application/x-www-form-urlencoded
accept: application/json
client_id={{oauth.client_id}}
&
client_secret={{oauth.client_secret}}
&
grant_type=refresh_token
&
refresh_token={{oauth.refresh_token}}