Application Nodes

5. Application Nodes​

The nodes in this section connect to external services. For each node, the connection setup is described first, followed by operations and parameters.

Outlook Node​

The Outlook node enables integration with your Microsoft Outlook email account in SkyStudio workflows. You can send emails and perform advanced searches in your inbox. Microsoft OAuth is used for the connection.

Connection Setup and Management​

To use the Outlook node, you need to authorize your Microsoft account with OAuth. No API key or token entry is required; authorization is done through Microsoft's official login screen.

Connecting to Microsoft Outlook​

1. Initiating the connection

1. In SkyStudio, add the Outlook node to the canvas.
2. Click the button to open the right panel.
3. Choose an operation (Send Mail or Search Mail).
4. Click the Connect to Microsoft Outlook button in the right panel.

2. Authorization with a Microsoft account

1. On the Microsoft sign-in screen that opens, sign in with your corporate or personal Microsoft account.
2. Approve SkyStudio's request for access to Outlook.
3. Once authorization is complete, the connection will become active in the right panel and the fields will become visible.

Note: Authorization takes place via Microsoft's standard OAuth 2.0 flow. SkyStudio does not see or store your password.

Adding a Connection in SkyStudio (Alternative Method)​

1. Go to the Application Connections section from the left-hand menu of SkyStudio.

2. Click the Add New Connection button.

3. Select Microsoft Outlook as your provider.

4. Enter a descriptive name in the Connection Name field (e.g., Company Outlook).

5. Click the Authorize with Microsoft button and complete the Microsoft login steps.

6. Once authorization is complete, the connection will be automatically saved.

Assigning the Connection to the Node​

After adding the Outlook node to the canvas, select the saved link from the Application Connections drop-down menu in the right panel.

Note: You can define separate links for different Microsoft accounts (e.g., personal and business).

Operations​

The Outlook node offers two operations:

Send Mail​

It sends emails through the linked Microsoft Outlook account. It is used in notification, report sharing, and automated reply scenarios.

Parameters​

Usage Example​

To send automated report emails from a workflow:

• To: director@company.com
• Subject: Weekly Sales Report
• Body: {{llm.output}}

Sample Output​

{
  "id": "message-id-abc123",
  "status": "sent",
  "to": ["director@company.com"],
  "subject": "Weekly Sales Report"
}

Search Mail​

Outlook searches for emails in the inbox using keyword, sender, or subject filters. It is used in email tracking and content extraction workflows.

Parameters​

Search Query Examples​

Sample Output​

{
  "value": [
    {
      "id": "message-id-xyz",
      "subject": "April Invoice Summary",
      "from": { "emailAddress": { "address": "muhasebe@company.com" } },
      "receivedDateTime": "2024-04-15T09:30:00Z",
      "bodyPreview": "The invoice summary for April is attached..."
    }
  ]
}

Example: Support Request Responder​

A workflow that reads incoming support emails, generates responses using AI, and sends them:

Search Mail → LLM (Generate Response) → Send Mail

Email Search settings:

• Search Query: subject:support
• Folder: Inbox
• Limit: 5

Email Sending Settings:

• To: Recipient email address
• Subject: Topic
• Body: {{llm.output}}

Outlook Calendar Node​

The Outlook Calendar node integrates with the Microsoft Outlook calendar in SkyStudio workflows. You can list, create, update, and delete events; check availability; and run AI-powered calendar queries. The connection uses the same Azure App Registration method as the Teams node.

Connection Setup and Management​

1. Connection Method​

Adding a Connection in SkyStudio​

1. Go to the Application Connections section from the left-hand menu of SkyStudio.

2. Click the Add New Connection button.

3. Select Outlook Calendar as the provider.

4. Select OAuth 2.0 as the connection method.

5. Specify who can select and run this connection in workflows.

6. Click on the “Connect Calendar with Microsoft” option.

Authorization via Microsoft account

1. On the Microsoft sign-in screen that opens, sign in with your corporate or personal Microsoft account.
2. Approve SkyStudio's request for access to Outlook.

2. Connection Method​

To use the Outlook Calendar node, you need to create an App Registration in the Azure Portal and enter the resulting Tenant ID, Client ID, and Client Secret into SkyStudio.

Note: The connection setup process for this node is exactly the same as for the Microsoft Teams node. If you have already created a Teams connection, you can use the same Azure App Registration information for Outlook Calendar.

Creating Azure App Registration​

1. Registering a new application

1. Go to portal.azure.com.

2. Type App registrations in the search bar and go to the relevant service.

3. Click the + New registration button.

4. Give the application a name (e.g., SkyStudio).

5. Select Accounts in this organizational directory only (Single tenant).

6. Click the Register button.

2. Copying Client ID and Tenant ID

After the application is created, on the Overview page:

• Application (client) ID → Your Client ID
• Directory (tenant) ID → Your Tenant ID

Copy both of them. This information can be accessed again later.

3. Creating Client Secrets

1. Go to the Certificates & secrets section in the left-hand menu.

2. Click the + New client secret button.

3. Add a Description and Expiration Date, then click the Add button.

4. Immediately copy the Value field of the created secret.

Important Note: The Client Secret value is only visible when it is created. You will not be able to access its full value again after closing the page.

4. Adding API Permissions

1. Go to the API permissions section in the left-hand menu.

2. Select + Add a permission → Microsoft Graph → Application permissions.

3. Add the necessary permissions for Outlook Calendar:

4. Confirm permissions by clicking the Grant admin consent button.

Adding a Connection in SkyStudio​

1. Go to the Application Connections section from the left-hand menu of SkyStudio.

2. Click the Add New Connection button.

3. Select Outlook Calendar as the provider.

4. Fill in the following fields:

5. Click the Save button.

Assigning the Connection to the Node​

After adding the Outlook Calendar node to the canvas, select the saved link from the Application Connections drop-down menu in the right panel.

Operations​

The Outlook Calendar node offers 10 operations:

Get Events​

Retrieves events from the calendar by date range and search filter.

Parameters​

Today's Events​

Returns today's calendar events for the linked account.

Parameters​

Upcoming Events​

Lists upcoming events within a specified number of days.

Parameters​

Availability Check​

Checks the availability of specified users for a particular time period. Used in appointment and meeting scheduling workflows.

Parameters​

Outlook Calendar AI Assistant​

Outlook queries calendar data using natural language. As shown in the video, calendar data can be easily accessed with questions such as "What are my meetings this week?".

Parameters​

Usage Example​

Query: "Could you list my meetings for this week?"

System Prompt: "List only this week's events. Respond in Turkish, showing title and time."

List Calendars​

Lists all calendars and Calendar IDs in the account.

Parameters​

Get Event​

Retrieves all the details of a specific event using its Event ID.

Parameters​

Create Event​

This adds a new event to your Outlook calendar. A Teams meeting link can also be created optionally.

Parameters​

Event Update​

Updates information for an existing event.

Parameters​

Delete Event​

Removes the specified event from the calendar.

Parameters​

Common Errors​

Notes​

• When the Calendar ID field is left blank, all operations will automatically run on the primary calendar.
• When Teams Meeting is open during the Create Event operation, a Teams meeting link is automatically created; this feature requires Azure App Registration to also have the OnlineMeetings.ReadWrite.All permission to work.
• Date/time fields are filled with values in the format YYYY-MM-DDTHH:MM:SS (e.g., 2024-06-01T10:00:00). Timezone is entered as a separate field.
• The Availability Check operation can check the availability of multiple users simultaneously. You can enter email addresses separated by commas.
• The connection will stop working when the Client Secret of Azure App Registration expires. It is recommended to create a new secret and update the SkyStudio connection before it expires.

Google Calendar Node​

The Google Calendar node enables integration with Google Calendar within SkyStudio workflows. You can read, create, update, and delete events; and run AI-powered natural language queries.

Connection Setup and Management​

To use the Google Calendar node, you first need to create a Google account link.

Adding a New Connection​

1. Go to the Application Connections section from the left-hand menu of SkyStudio.

2. Click the Add New Connection button.

3. Select Google Calendar as your provider.

4. Click the Authorize with Google button.

5. In the Google OAuth window that opens, select your account and grant the necessary permissions.

6. The connection is automatically saved once authorization is complete.

Note: The Google Calendar node uses the OAuth 2.0 protocol. Your password is not transmitted to SkyStudio; only the access token provided by Google is stored.

Assigning the Connection to the Node​

After adding the Google Calendar node to the canvas, select the Google account link you created earlier from the App Links drop-down menu in the right panel.

What is Calendar ID?​

Calendar ID specifies which calendar to use.

To find your calendar ID: Google Calendar → Calendar Settings → "Calendar integration" section → Calendar ID field.

Operations​

The Google Calendar node offers 9 operations:

Get Events​

Returns calendar events within a specified date range. Used in reporting and event filtering scenarios.

Parameters​

Sample Output​

{
  "items": [
    {
      "id": "abc123xyz",
      "summary": "Project Meeting",
      "start": { "dateTime": "2024-11-15T10:00:00" },
      "end": { "dateTime": "2024-11-15T11:00:00" },
      "location": "Meeting Room 1",
      "status": "confirmed"
    }
  ]
}

Today's Events​

Automatically retrieves all events taking place today in the selected calendar. Ideal for getting a daily summary without entering a date parameter.

Parameters​

Note: If no time zone is specified, UTC will be used. For workflows running in Türkiye, enter Europe/Istanbul.

Upcoming Events​

It retrieves events from the current timeframe within the specified number of days. Suitable for reminder and notification workflows.

Parameters​

Google Calendar AI Assistant​

It allows you to query calendar data using natural language. It's ideal for accessing information without typing complex date/time filters.

Parameters​

Usage Example​

Query: "How many meetings do I have this weekend?"

System Prompt: "Only count events that contain the word 'Meeting'."

Note: You can use System Prompt to define restrictions for the AI assistant, such as specific calendars, contacts, or event categories.

List Calendars​

This returns all calendars linked to your Google account (personal, shared, team calendars, etc.). It's used to find out which calendars you have access to and their Calendar ID values.

Parameters​

Sample Output​

{
  "items": [
    {
      "id": "primary",
      "summary": "Ahmet Yılmaz",
      "primary": true,
      "accessRole": "owner"
    },
    {
      "id": "tr.turkish#holiday@group.v.calendar.google.com",
      "summary": "Holidays in Türkiye",
      "accessRole": "reader"
    }
  ]
}

Get Event​

Retrieves all details of a single calendar event with a specific Event ID.

Parameters​

How to Find the Event ID?​

The id field in the output returned from the "Fetch Events" or "Today's Events" operations is the Event ID of that event. It can also be copied from the URL by opening the event in the Google Calendar web interface.

Create Event​

Creates a new event in Google Calendar. Invitations for participants, location, and all-day events are supported.

Parameters​

Attendees Usage​

To add multiple participants, separate their email addresses with commas:

ali@company.com, ayse@company.com, mehmet@partner.com

Each participant will automatically receive a Google Calendar invitation.

All Day Event Mode​

When the All Day Event is enabled, the Start Date Time and End Date Time fields will still use the same format (2024-12-31T00:00:00), but the time information will be ignored; the event will be marked as an all-day event.

Event Update​

Updates the information for an existing calendar event. Only the entered fields are changed; unentered fields retain their current values.

Parameters​

Note: When the Attendees field is entered, the entire existing participant list will be replaced with the new list. If you want to keep your existing participants, first retrieve the existing list using "Get Event" and add them to the new list.

Delete Event​

Permanently deletes a calendar event. This action is irreversible.

Parameters​

Note: The deletion process is permanent and irreversible. Please ensure the Event ID is correct before deleting.

Common Errors​

Notes​

• All date/time values must be entered in the format YYYY-MM-DDTHH:MM:SS, e.g., 2024-06-01T10:00:00. Values can be entered manually in these fields or parameters can be linked using /. Timezone offset (such as +03:00) is not added to the datetime string; the time zone is specified separately in the Timezone field.
• The valid values for the Timezone field are based on the IANA time zone database. For Türkiye, use Europe/Istanbul.
• The Google Calendar API has a limit of 10 requests per second. For workflows processing a large number of events, it's recommended to add a delay between requests.
• For recurring events, Event Deletion will only delete the single relevant instance; use the Google Calendar interface to delete the entire series.
• When All Day Event is enabled, the Timezone setting is ignored.

Google Drive Node​

The Google Drive node enables integration with Google Drive and Google Sheets within SkyStudio workflows. You can perform file reading, searching, folder management, and spreadsheet operations.

Connection Setup and Management​

To use the Google Drive node, you first need to create a Google account link. Unlike Jira and Confluence, Google Drive uses OAuth 2.0 authentication.

Adding a New Connection​

1. Go to the Application Connections section from the left-hand menu of SkyStudio.

2. Click on the Google Drive option.

3. Ensure that OAuth 2.0 is selected as the connection method (default and recommended).

4. Enter a name for this link in the Connection Name field (required).

5. Click the Authorize with Google button.

Connection Methods​

OAuth 2.0 (Recommended) Authorization is done via your Google account through the browser. Once the backend OAuth URL is configured, it opens with a single click. It is the most secure and easiest method.

API Key / Advanced You can manually enter the credentials in JSON format. Choose this method if you want to use your own Google Cloud OAuth client.

Authorization Steps​

1. Click the Authorize with Google button.

2. In the Google sign-in window that opens, select your account.

3. Grant the permissions requested by SkyStudio.

4. The connection is automatically saved once authorization is successful.

Note: During authorization, Google will request permission to access Drive and Sheets. Approve all requested permissions for your workflows to function correctly.

Assigning the Connection to the Node​

After dragging the Google Drive node to the canvas, select the link you created earlier from the App Links drop-down menu in the right panel.

Operations​

The Google Drive node offers 13 operations:

List Files​

Lists all files and subfolders in a specific folder. If no folder ID is provided, the root directory of Drive is listed.

Parameters​

How to Find Folder ID?​

Open the folder in Google Drive. The last segment in the URL is the Folder ID. Example: https://drive.google.com/drive/folders/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs → ID: 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs

File Search​

Google Drive searches for files using search syntax. Filtering can be done based on criteria such as name, content, and MIME type.

Parameters​

Google Drive AI Assistant​

It queries your Drive files using natural language. It's used to interpret file contents and extract information.

Parameters​

Usage Example​

Query: "Find and summarize the meeting notes shared last month"

System Prompt: "Only check the files in the 'Meeting Notes' folder. Provide your response in Turkish."

Get Spreadsheet Rows​

Retrieves rows from Google Sheets within a specific range in JSON format.

Parameters​

How to Find Spreadsheet ID?​

The part of the Google Sheets URL between /d/ and /edit is the Spreadsheet ID. Example: https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs/edit → ID: 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs

Range Format​

• Entire page: Sheet1 or Page1
• Specific range: Sheet1!A1:D50
• Entire column A: Sheet1!A:A
• First 10 lines: Sheet1!1:10

Read File Contents​

It reads the contents of a file in Google Drive. Depending on the reading method, it can return raw text, AI analysis, or structured data.

Parameters​

Supported File Types​

Google Docs, Google Sheets, Google Slides, PDF, TXT, DOCX, and other text-based files can be read.

Ask the File​

It allows you to ask questions about a Drive file in natural language. The file contents are automatically uploaded and processed by AI.

Parameters​

Usage Example​

File ID: 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs

Question: "What are the main findings in this report? List them point by point."

Response Language: Turkish

Get File Information​

It retrieves metadata information about a file, such as its name, size, creation date, and MIME type. It does not read the file contents.

Parameters​

Sample Output​

{
  "id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs",
  "name": "Q4 Sales Report.pdf",
  "mimeType": "application/pdf",
  "size": "245760",
  "createdTime": "2024-10-01T09:00:00.000Z",
  "modifiedTime": "2024-11-15T14:30:00.000Z",
  "webViewLink": "https://drive.google.com/file/d/..."
}

Create Folder​

Creates a new folder in Google Drive. It can also be created inside an existing folder.

Parameters​

Spreadsheet Information​

This retrieves structural metadata information from a Google Sheets file, such as sheet names and row/column counts.

Parameters​

Add Row​

Adds new row(s) to an existing Google Sheets page.

Parameters​

Rows Format​

[
  { "First Name": "Ayşe", "Last Name": "Kaya", "Department": "Marketing" },
  { "First Name": "Mehmet", "Last Name": "Demir", "Department": "Engineering" }
]

Cell Update​

Updates cell values within a specific range in Google Sheets.

Parameters​

Values Format​

[
  ["New Value 1", "New Value 2"],
  ["New Value 3", "New Value 4"]
]

Clear Cells​

Deletes the contents of a specific range of cells in Google Sheets (format is preserved).

Parameters​

Note: This process only deletes the cell contents; it preserves cell formatting (color, font, etc.).

Create Spreadsheet​

It creates a new Google Sheets file. You can define the desired sheet names at the beginning.

Parameters​

Sample Output​

{
  "spreadsheetId": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs",
  "spreadsheetUrl": "https://docs.google.com/spreadsheets/d/...",
  "title": "2025 Sales Tracking Chart"
}

Common Errors​

Notes​

• File ID and Spreadsheet ID are the same concept — every Google Sheets file is also a Drive file.
• The Google Drive API has daily request limits. When processing large datasets, consider Page Size and request intervals.
• Query File and Read File Contents (AI analysis) operations may take longer with large files.
• Binary files (images, videos, etc.) outside of Google Workspace (Docs, Sheets, Slides) may not be supported for reading content.

Google Maps Node​

The Google Maps node enables integration with Google Maps Platform within SkyStudio workflows. You can automate tasks such as address/coordinate conversion, distance calculation, nearby place search, getting directions, and creating static map visualizations.

Connection Setup and Management​

To use a Google Maps node, you need a Google Maps API key.

Obtaining API Key​

1. Go to Google Cloud Console.

2. Create a project or select an existing one.

3. Enable the following APIs from the APIs & Services → Library section:

• Maps JavaScript API
• Geocoding API
• Places API
• Directions API
• Distance Matrix API
• Maps Static API

4. In the APIs & Services → Credentials section, select Create Credentials → API Key.

5. Copy the generated API key.

Adding a Connection in SkyStudio​

1. Go to the Application Connections section from the left-hand menu of SkyStudio.

2. Click the Add New Connection button.

3. Select Google Maps as your provider.

4. Paste your API key into the appropriate field and save.

Assigning the Connection to the Node​

After adding the Google Maps node to the canvas, select the link you created from the App Links drop-down menu in the right panel.

Note: The same connection is used for every operation. You can define multiple connections with different API keys for different projects.

Operations​

The Google Maps node offers 9 operations:

Address → Coordinates​

It converts a text address into latitude and longitude coordinate values. This process is also known as geocoding.

Parameters​

Sample Output​

{
  "lat": 41.0369,
  "lng": 28.9850,
  "formatted_address": "Taksim Square, Beyoğlu/Istanbul, Türkiye"
}

Distance & Time​

Calculates the distance and estimated travel time from one or more starting points to one or more destinations (Distance Matrix).

Parameters​

Origins / Destinations Format​

One single point: Kadıköy, Istanbul

Multiple locations: Kadıköy, Istanbul|Beşiktaş, Istanbul

Nearby Places​

Lists locations within a specified radius around a given coordinate point. Filtering is possible by category, such as restaurants, pharmacies, ATMs, etc.

Parameters​

Place Type Examples​

restaurant, cafe, hospital, pharmacy, bank, atm, gas_station, hotel, supermarket, school, park

Location Search​

It searches for locations and addresses on Google Maps using text-based search queries. It is used in location search scenarios based on user input.

Parameters​

Sample Output​

{
  "results": [
    {
      "place_id": "ChIJLU7jZClu0xQRIOd2kzuSCZU",
      "name": "Istanbul Airport",
      "formatted_address": "Tayakadın, 34283 Arnavutköy/İstanbul",
      "geometry": {
        "location": { "lat": 41.2608, "lng": 28.7418 }
      },
      "rating": 4.3
    }
  ]
}

Map AI Assistant​

It queries Google Maps data using natural language. It performs complex search and filtering operations in a simple question format.

Parameters​

Usage Example​

Query: "Find the 3 pharmacies closest to Kadıköy"

System Prompt: "List only places that are open 24 hours and provide their addresses in Turkish."

Coordinates → Address​

It converts latitude/longitude coordinates into a readable text address. This is a reverse geocoding process.

Parameters​

Sample Output​

{
  "formatted_address": "Sultanahmet, Fatih/Istanbul 34122, Türkiye",
  "address_components": [
    { "long_name": "Sultanahmet", "types": ["neighborhood"] },
    { "long_name": "Fatih", "types": ["sublocality"] },
    { "long_name": "Istanbul", "types": ["locality"] }
  ]
}

Directions​

It generates step-by-step directions between two points. Waypoints can be added; different modes of transport are supported.

Parameters​

Using Waypoints​

Uskudar, Istanbul | Bostanci, Istanbul

Each waypoint creates an intermediate stop; the route passes through all the points in sequence.

Location Details​

Using a place's Place ID, it retrieves detailed information about that place: phone number, opening hours, website, photos, reviews, and more.

Parameters​

How to Find Place ID?​

The place_id field in the output of the "Find Place" operation can be used directly. The Place ID can also be copied by right-clicking a place in the Google Maps web interface.

Fields Examples​

name, rating, formatted_address, formatted_phone_number, website, opening_hours, photos, reviews, price_level, geometry

Map Image​

Creates a static map image (PNG) centered on the specified location. Used to add maps to workflow outputs or reports.

Parameters​

Zoom Guide​

Quick Start Examples​

Common Errors​

Notes​

• For the Language field, ISO 639-1 language codes are used: tr for Turkish, en for English, and de for German.
• The Radius (Nearby Locations) can be a maximum of 50,000 meters; larger values will be automatically clipped.
• The Map Image operation can return a PNG binary directly instead of an image URL; it's possible to save it in the workflow using the "File Output" node.
• The Google Maps API uses a per-request pricing model. For high-volume workflows, consider caching results to optimize costs.
• The Place ID may change over time; instead of storing it long-term, it is recommended to retrieve the updated ID each time using "Search Location".

SharePoint Node​

The SharePoint node lets you access list data, files, and pages from your Microsoft SharePoint site in SkyStudio workflows. You can read, create, and update list items; upload and download files; and run AI-powered content queries. Azure App Registration is used for connection.

Connection Setup and Management​

1. Connection Method​

Adding a Connection in SkyStudio​

1. Go to the Application Connections section from the left-hand menu of SkyStudio.

2. Click the Add New Connection button.

3. Select SharePoint as your provider.

4. Select OAuth 2.0 as the connection method.

5. Specify who can select and run this connection in workflows.

6. Click on the “Connect SharePoint with Microsoft” option.

Authorization via Microsoft account

1. On the Microsoft sign-in screen that opens, sign in with your corporate or personal Microsoft account.
2. Approve SkyStudio's request for access permission from SharePoint.

2. Connection Method​

To use the SharePoint node, you need to create an App Registration in the Azure Portal and enter the resulting Tenant ID, Client ID, and Client Secret along with your SharePoint Site URL into SkyStudio.

🎬 Click here to watch the video → How to set up a SharePoint connection?

Note: The Azure setup process for this node is exactly the same as for Microsoft Teams and Outlook Calendar nodes. If you have already created App Registration for one of these nodes, you can use the same information for SharePoint.

Creating Azure App Registration​

1. Registering a new application

1. Go to portal.azure.com.

2. Type App registrations in the search bar and go to the relevant service.

3. Click the + New registration button.

4. Give the application a name (e.g., SkyStudio).

5. Select Accounts in this organizational directory only (Single tenant).

6. Click the Register button.

2. Copying Client ID and Tenant ID

After the application is created, on the Overview page:

• Application (client) ID → Your Client ID
• Directory (tenant) ID → Your Tenant ID

3. Creating Client Secrets

1. Go to the Certificates & secrets section in the left-hand menu.

2. Click the + New client secret button.

3. Add a Description and Expiration Date, then click the Add button.

4. Immediately copy the Value field of the created secret.

Note: The Client Secret value is only visible when it is created. You will not be able to access its full value again after closing the page.

4. Adding API Permissions

1. Go to the API permissions section in the left-hand menu.

2. Select + Add a permission → Microsoft Graph → Application permissions.

3. Add the necessary permissions for SharePoint:

4. Confirm permissions by clicking the Grant admin consent button.

Adding a Connection in SkyStudio​

1. Go to the Application Connections section from the left-hand menu of SkyStudio.

2. Click the Add New Connection button.

3. Select SharePoint as your provider.

4. Fill in the following fields:

5. Click the Save button.

Assigning the Connection to the Node​

After adding the SharePoint node to the canvas, select the link you saved from the Application Connections drop-down menu in the right panel.

Note: You can define separate links for different SharePoint sites. Use the same Tenant/Client information for each link and only change the Site URL.

Operations​

The SharePoint node offers 11 operations:

Retrieve List Items​

Querying items in a SharePoint list using an OData filter. Used in project tracking, task management, or data reporting workflows.

Parameters​

OData Filter Examples​

List Files​

Lists files in a specific document library or folder.

Parameters​

Search​

Searches content on a SharePoint site using keywords. Searches can be performed across all content, including list items, files, and pages.

Parameters​

SharePoint AI Assistant​

This tool queries SharePoint content using natural language. As shown in the video, you can write queries in natural language such as "get folder names".

Parameters​

Usage Example​

Query: "Which files were uploaded to the Documents library this month?"

System Prompt: "Show only content created within the last 30 days. Respond in Turkish."

List Sites​

It lists SharePoint sites within the organization based on the search query. It is used to discover site URLs.

Parameters​

Get List Item​

Retrieves all the details of a specific list item using its Item ID.

Parameters​

Create List Item​

Adds a new item to the specified SharePoint list.

Parameters​

Fields (JSON) Example​

{
  "Title": "New Project Assignment",
  "Status": "Not started",
  "Priority": "High",
  "AssignedTo": "ahmet@company.com"
}

Update List Item​

Updates the fields of an existing list item.

Parameters​

Download / Read File​

It downloads a file from SharePoint or reads its contents as text. It is used in AI-based content analysis scenarios.

Parameters​

Upload File​

Uploads files to a document library.

Parameters​

Read Page Contents​

It reads the content of the specified SharePoint page. It is used in knowledge base and content management workflows.

Parameters​

Common Errors​

Notes​

• The Site URL field is entered only once during linking and applies to all operations used by that link. Define separate links to access different sites.
• The List Name field is case-sensitive. Use the full list name in SharePoint (e.g., Documents or Belgeler).
• In the Fields (JSON) field, enter only the fields you wish to update. Other fields will remain unchanged.
• In the Download/Read File operation, if there is no Item ID, the File Path (relative path) can be used. If both are entered, the Item ID takes precedence.
• For OData filter syntax, ensure you use SharePoint internal names for the field names; the display name can be different.
• The connection will stop working when the Azure App Registration Client Secret expires. It is recommended to renew it before it expires.

Microsoft Teams Node​

The Microsoft Teams node integrates with your Microsoft Teams workspace in SkyStudio workflows. You can read and send channel messages, create meetings, share files, and run AI-powered queries. An App Registration on Azure is required for connection.

Connection Setup and Management​

1. Connection Method​

Adding a Connection in SkyStudio​

1. Go to the Application Connections section from the left-hand menu of SkyStudio.

2. Click the Add New Connection button.

3. Select Microsoft Teams as your provider.

4. Select OAuth 2.0 as the connection method.

5. Specify who can select and run this connection in workflows.

6. Click on the “Connect Teams with Microsoft” option.

Authorization via Microsoft account

1. On the Microsoft sign-in screen that opens, sign in with your corporate or personal Microsoft account.
2. Approve SkyStudio's request for access permission from Teams.

2. Connection Method​

To use the Teams node, you need to create an App Registration in the Azure Portal, define the necessary permissions (Graph API permissions), and enter the resulting Tenant ID, Client ID, and Client Secret into SkyStudio.

🎬 Click here to watch the video → How to set up Microsoft Teams connection?

Creating Azure App Registration​

1. Registering a new application

1. Go to portal.azure.com.

2. Type App registrations in the search bar to go to the App registrations service.

3. Click the + New registration button.

4. Give the application a name (e.g., SkyStudio).

5. Select Accounts in this organizational directory only (Single tenant) as Supported account types.

6. Click the Register button.

2. Copying Client ID and Tenant ID

The following information is displayed on the Overview page that opens after the application is created:

• Application (client) ID → this is your Client ID
• Directory (tenant) ID → this is your Tenant ID

Copy both and save them somewhere. You can access this information again later.

3. Creating Client Secrets

1. Go to the Certificates & secrets section in the left-hand menu.

2. On the Client secrets tab, click the + New client secret button.

3. Enter a Description and select an Expiration.

4. Click the Add button.

5. Immediately copy the value in the Value column of the newly created secret.

Note: The Client Secret value is only visible when it is created. You will not be able to access its full value again after closing the page. If you forget to copy it, you will need to delete the secret and create it again.

4. Adding API Permissions

1. Go to the API permissions section in the left-hand menu.

2. Click the + Add a permission button.

3. Select Microsoft Graph.

4. Select the Application permissions tab.

5. Search for and add the necessary permissions for the Teams node:

6. After adding the permissions, confirm them by clicking the Grant admin consent button.

Note: You need a Microsoft 365 administrator account to obtain admin consent. If you are not authorized, please contact your IT department.

Adding a Connection in SkyStudio​

1. Go to the Application Connections section from the left-hand menu of SkyStudio.

2. Click the Add New Connection button.

3. Select Microsoft Teams as your provider.

4. Fill in the following fields:

5. Click the Save button.

Assigning the Connection to the Node​

After adding the Microsoft Teams node to the canvas, select the saved link from the App Links drop-down menu in the right panel.

Operations​

Microsoft Teams Node offers 12 operations:

List Channels​

Returns all channels in the specified team. Used to discover channel IDs.

Parameters​

Read Channel Messages​

Returns the message history for the specified channel.

Parameters​

Send a Message to the Channel​

Sends a message to the specified Teams channel. Used in notification and report sharing workflows.

Parameters​

Send Chat Message​

Sends a message to a specific Teams chat (one-on-one or group chat).

Parameters​

Create Meeting​

It creates a new Microsoft Teams meeting and returns a join link.

Parameters​

Teams AI Assistant​

It queries Teams data using natural language. As you can see from the video transcript, you can, for example, ask for the title of the last meeting in natural language.

Parameters​

Usage Example​

Query: "What was the title of my last meeting?"

System Prompt: "Only consider meetings from the last 7 days. Respond in Turkish."

List Teams​

Lists all teams in the organization. Used to discover Team IDs.

Parameters​

List Chats​

Lists the chats (one-on-one and group) the user is involved in.

Parameters​

User Information​

Returns the Microsoft 365 profile information (by ID or email) of a specific user.

Parameters​

List Users​

It lists users within the organization, and can be searched by name.

Parameters​

Send File​

Sends a file to a Teams channel. The file content can be provided as base64 or plain text.

Parameters​

Meeting Records​

Returns the registration information and access links for a specific meeting.

Parameters​

Common Errors​

Notes​

• The default validity period for Client Secrets in Azure is 6 months or 1 year. When it expires, you need to create a new secret in Azure and update the SkyStudio connection.
• The account entered in the User Email field must have access to Teams and must be a member of the organization.
• API permissions require Admin consent; this can only be done by users with the Microsoft 365 Global Admin or Application Admin role.
• In the Send File operation, you may need to convert the contents of large files to base64 format; you can do this in a previous node (e.g., LLM or Transform).
• The Teams AI Assistant operation can query all Teams data accessible to the connected account.

Slack Node​

The Slack Node enables integration with your Slack workspace in SkyStudio workflows. You can send messages to channels, read channel history, search messages, pull up channel and user lists, and run natural language queries with the Slack AI Assistant. A Slack Bot Token is used for connection.

Connection Setup and Management​

To use Slack Node, you need to create an application (Slack App) in your Slack workspace and obtain a Bot Token.

Obtaining Slack Bot Tokens​

1. Go to api.slack.com/apps in your browser and sign in with your Slack account.

2. Click the Create New App button and select the From scratch option.

3. Give the application a name and select the Slack workspace you will use.

4. Go to OAuth & Permissions from the left menu.

5. Under the Scopes heading, add the following permissions to the Bot Token Scopes section:

6. Click the Install to Workspace button at the top of the page and approve the permissions.
7. Once the installation is complete, the Bot User OAuth Token will be displayed (starting with xoxb-). Copy this value.

Note: Bot Tokens start with the prefix xoxb-. Always use Bot Tokens, not User Tokens (xoxp-).

Adding a Bot to the Channel​

The bot can only send messages to channels it's a member of and read the history of those channels.

1. Open the relevant channel in the Slack app.
2. Type /invite @app_name in the message box and send it.
3. The process is complete when the bot is added to the channel.

Adding a Connection in SkyStudio​

1. Click the chain icon (Application Connections) in the bottom toolbar of the workflow canvas.
2. In the window that opens, click the + New link button.
3. Select Slack from the provider list (it's under the collaboration category).
4. Fill in the following fields:

5. Click the Add link button.

Note: Instead of filling in all the fields individually, you can click the "Edit as Raw JSON" button to paste the configuration as JSON.

Access Level Selection​

Assigning the Connection to the Node​

After adding the Slack node to the canvas, select the saved link from the App Links dropdown menu in the right panel.

Operations​

The Slack node offers 7 operations:

Send Message​

It sends a message to the specified channel or person. It is the most frequently used operation in notification, report sharing, and alert scenarios.

Parameters​

Usage Example​

To send automated alerts from a workflow:

• Channel: #sales-notifications
• Text: Daily sales report ready: {{llm.output}}

Sample Output​

{
  "ok": true,
  "channel": "C0123ABC456",
  "ts": "1718352000.000100",
  "message": {
    "text": "Daily sales report ready",
    "user": "U0BOT123"
  }
}

Fetch Channel Messages​

Retrieves the message history of the specified channel. Used in scenarios such as channel summarization and daily digest creation.

Parameters​

Sample Output​

{
  "messages": [
    {
      "user": "U01ABCDEF",
      "text": "The meeting has been postponed to 15:00",
      "ts": "1718352000.000100"
    }
  ],
  "has_more": false
}

Search in Messages​

Searches for messages across the workspace using keyword, channel, or person filters.

Parameters​

Search Query Examples​

Slack AI Assistant​

It queries Slack data using natural language. It's used to ask what's being discussed in which channel.

Parameters​

Usage Example​

Query: "What decisions were made in the product channel this week?"

System Prompt: "Display the results item by item, in Turkish and chronological order."

List Channels​

Lists the channels in the workspace. Used to find out the channel IDs.

Parameters​

Get Channel Members​

Returns a list of members in the specified channel.

Parameters​

List Users​

Lists all users in the workspace. Used to find out user IDs.

Parameters​

Common Errors​

Notes​

• The bot token is in the format xoxb- and only works in channels where the bot has been added.
• The Search Messages operation requires search:read permission; this permission may be limited in free Slack plans.
• To access private channels, the bot must be manually invited to that channel.
• To send rich-format messages, you can provide Slack Block Kit JSON in the Blocks field.
• To reply to a message within a thread, enter the original message's ts value in the Thread TS field.
• It's safer to use a channel ID instead of a channel name; the ID remains the same even if the channel name is changed.

Jira Node​

SkyStudio's Jira integration allows you to directly connect your Jira projects to your workflows. You can automate all essential Jira operations, from issue management and sprint tracking to commenting and worklogging.

Connection Setup and Management​

To use Jira nodes, you first need to define a Jira connection. Connections are reusable across all your workflows; once defined, simply select them on each node.

Creating a New Connection​

Go to the Application Connections screen. Select New Connection. Choose Jira from the provider list and fill in the following information:

Connection Form Fields

Note: Follow these steps: id.atlassian.com → Security → API tokens, create a new token, and copy and paste it into this field.

Once you fill out the form and click Save, the link will be saved and become available on all Jira nodes.

Steps to Obtain Jira API Key

• Log in to your Jira account and click on the profile (avatar) icon in the upper right corner.
• From the menu that opens, click on "Account settings / Manage account".
• Go to the "Security" tab in the left menu.
• On the security page, find the "API tokens" section and click the "Create API token" button.
• In the window that opens, give the token a descriptive name indicating its purpose.
• Set a validity period for the token (between 1 and 365 days, default 1 year).
• Create the key by clicking the "Create" button.
• Copy the generated key using "Copy to clipboard" and save it in a safe place (preferably a password manager).

Note: You will not be able to view the token again after leaving this screen; therefore, you must copy and save it to a safe place immediately after creating it. If you want to create a token with specific permissions (scoped), you can use the "Create API token with scopes" option on the same page and select the relevant application (Jira/Confluence) and permission scopes.

Assigning the Connection to the Node​

After establishing a connection, you can view and select your defined connections from the Application Connections dropdown menu on each Jira node. Once a connection is selected, credentials are automatically merged during the run and test processes; the Connection field on the node serves as an optional backup.

Viewing Active Connections​

You can see all the tool connections used in the current workflow by clicking the Active Connections button in the upper right corner of Canvas. Published workflows run through these connections; it is recommended that you evaluate which access information is valid for external access scenarios according to your corporate policies.

Note: You can add dynamic values from other nodes in the workflow by typing / in the connection field.

Operations​

The SkyStudio Jira node supports the following 14 operations. The first three operations are marked as Featured and are designed for the most frequently used scenarios.

Featured Operations​

Get Issue​

In Jira, this retrieves a specific issue using its key. Use it when you want to access all the details of a single issue.

Input Parameters

Output

The issue returns a JSON object containing all the requested fields. This includes standard fields such as summary, status, assignee, priority, description, created, and updated.

Example Usage

To get only the summary and status information, enter ENG-101 in the Issue Key field and summary,status in the Fields field.

Search Issues (JQL)​

Jira uses Query Language (JQL) to filter and list multiple issues. It's ideal for retrieving issues that match specific criteria in bulk.

Input Parameters

Output

It returns an array containing a list of issues that match the JQL query. Each element contains the requested fields.

JQL Examples

project = ENG AND status = "To Do"
assignee = currentUser() AND sprint in openSprints()
project = BUGS AND priority = High AND created >= -7d
labels = "backend" ORDER BY created DESC

Jira AI Assistant​

Jira is an AI-powered assistant that lets you query your data using natural language. It allows you to run complex queries without requiring JQL knowledge.

Input Parameters

Output

The assistant interprets the query, retrieves the relevant Jira data, and generates a response in natural language format.

Example Usage

By typing "List critical bugs opened in the last 3 days" in the Query field, you can retrieve the relevant issues without writing any JQL.

Issue Management​

Create Issue​

It creates a new issue in Jira. It can be used in automated bug tracking, task generation, or support request workflows.

Input Parameters

Output

The generated issue returns a JSON object containing its id, key, and self (URL) information.

Change Issue Status​

Updates the status of an existing issue. Used to automate workflow transitions.

Input Parameters

Output

A successful operation returns an empty response (HTTP 204).

Note: If you don't know the Transition ID, first run the Get Issue Transitions operation to list the available transitions and their IDs for the relevant issue.

Get Issue Transitions​

Lists the current status transitions and transition IDs for an issue. Used before the Change Issue Status operation.

Input Parameters

Output

For each pass, it returns an array containing id, name (e.g., "In Progress", "Done"), and to` (target status).

Project Operations​

List Projects​

Lists all accessible projects in the linked Jira account.

Input Parameters

Output

It returns an array containing the id, key, name, and projectTypeKey information for each project.

Get Project​

Retrieves the details of a specific project using a key value.

Input Parameters

Output

The project returns a JSON object containing the id, key, name, description, lead, and configuration information.

Board Operations​

List Boards​

Lists the Scrum or Kanban boards for a project.

Input Parameters

Output

It returns a set of information for each board including id, name, and type (scrum or kanban).

Sprint Operations​

Bring Sprint Issues​

Lists all issues for a specific sprint. Used for sprint-based reporting and automation.

Input Parameters

Output

It returns a list of issues related to the sprint.

Comment Operations​

Get Comments​

Lists all comments made on an issue.

Input Parameters

Output

For each comment, it returns an array containing information such as id, author, body (comment content), and created (date).

Add Comment​

Adds a new comment to an existing issue. Can be used to send notifications, update status, or leave notes.

Input Parameters

Output

The generated comment returns a JSON object containing its id, author, body, and created information.

Worklog Operations​

Get Worklogs​

Lists all worklog records saved on an issue.

Input Parameters

Output

For each worklog entry, it returns an array containing information such as id, author, timeSpent, timeSpentSeconds, and started (start date).

Add Worklog​

Adds a new time tracking record to an issue. Used to automatically log run times.

Input Parameters

Output

The generated worklog record returns a JSON object containing the id, author, timeSpent, timeSpentSeconds, and started information.Example 1: Error Automation

Automatically open error information from a form as an issue in Jira:

1. Obtain error information from the user using the Text Input node.

2. Connect to the Create Issue node; set Project Key: BUGS, Issue Type: Bug, Priority: High.

Add source information to the issue created with the 3. Add Comment node. Example 2: Sprint Status Report

Report the status of all issues in the active sprint:

1. Enter the sprint ID using the Fetch Sprint Issues node.

2. Summarize the data using the Jira AI Assistant or Data Analysis node.

3. Text Output Send the report to the user. Example 3: Automatic Worklog

Automatically create a time record when a task is completed:

1. Change the issue status to Done using the Change Issue Status node.

2. Using the Add Worklog node, record the values Time Spent: 1h and Comment: Autocompleted.

Common Errors​

Confluence Node​

The Confluence node enables integration with Atlassian Confluence within SkyStudio workflows. You can read Confluence pages, fields, and blog posts; and run AI-powered natural language queries.

Connection Setup and Management​

To use the Confluence node, you first need to establish an Atlassian connection.

Adding a New Connection​

1. Go to the Application Connections section from the left-hand menu of SkyStudio.

2. Click the Add New Connection button.

3. Fill in the following information:

API Token Generation​

1. Go to id.atlassian.com/manage-profile/security/api-tokens.

2. Click the Create API token button.

3. Give the token a label (e.g., SkyStudio) and create it.

4. Copy the generated token and paste it into the API Token field in SkyStudio.

Note: The API token can only be viewed once. Don't forget to copy it immediately.

Assigning the Connection to the Node​

After dragging the Confluence node onto the canvas, select the connection you created earlier from the Application Connections drop-down menu in the right panel. If manual mode is selected, you can enter the connection information directly into the field.

Operations​

The confluence node offers 7 operations:

List Fields​

Confluence returns all the spaces in your account. It's used to discover which spaces you have access to and learn their Space Key values.

Parameters​

Sample Output​

{
  "results": [
    {
      "id": "123456",
      "key": "TECH",
      "name": "Technical Documentation",
      "type": "global",
      "status": "current"
    }
  ]
}

Confluence AI Assistant​

It allows you to query Confluence data using natural language. It's ideal for accessing information without writing complex Confluence queries.

Parameters​

Usage Example​

Query: "Find pages related to the onboarding process"

System Prompt: "Only consider pages updated in the last 6 months"

Note: You can define specific restrictions for the AI assistant using System Prompt, such as a particular field, author, or time period.

List Pages​

Returns a list of pages within a specific Confluence space.

Parameters​

Sample Output​

{
  "results": [
    {
      "id": "98765",
      "title": "API Integration Guide",
      "space": { "key": "TECH" },
      "version": { "number": 5 },
      "_links": { "webui": "/spaces/TECH/pages/98765" }
    }
  ]
}

Retrieve Page Content​

Retrieves the full content of a page in Confluence using its page ID.

Parameters​

How to Find Page ID?​

Open the page in Confluence. The numerical value after /pages/ in the URL is the Page ID. Example: https://sirketim.atlassian.net/wiki/spaces/TECH/pages/98765 → Page ID: 98765

Body Format Options​

• storage — Confluence's internal XML format (default)
• view — HTML view format
• export_view — HTML optimized for export.

Fetch Subpages​

It retrieves all direct or entire hierarchical subpages of a parent page. Useful for mapping page trees.

Parameters​

About Recursive Mode​

When the Recursive (All Children) option is disabled, only the direct subpages one level below are retrieved. When enabled, the entire hierarchy (including grandchildren) is retrieved.

Get Page History​

Returns the entire revision history of a Confluence page. Suitable for audit and tracking scenarios with information on who modified it and when.

Parameters​

Sample Output​

{
  "results": [
    {
      "number": 7,
      "when": "2024-11-15T10:23:00.000Z",
      "by": { "displayName": "Ahmet Yılmaz" },
      "message": "Installation steps updated"
    }
  ]
}

Retrieve Blog Pages​

Lists blog posts from a specific Confluence area.

Parameters​

Common Errors​

Notes​

• The File Path parameter is used to save the result directly to a file in operations that return large amounts of data. You can then process this file within the workflow.
• The Get All (Auto Paginate) option may cause slowdowns in fields with a large number of records; it is recommended to use it in conjunction with Limit.
• Confluence Cloud and Confluence Server APIs are different; this node is designed for Confluence Cloud (Atlassian Cloud).

Notion Node​

The Notion node enables integration with your Notion workspace in SkyStudio workflows. You can read page and database records, create new pages, add content to existing pages, and run AI-powered queries.

Connection Setup and Management​

To use the Notion node, you need to create an Internal Integration in Notion and add the generated token to SkyStudio. You also need to share the pages and databases you want the integration to access with the integration itself.

Getting Notion Integration Tokens​

1. Creating an Integration

1. Go to notion.so/my-integrations.

2. Click the + New integration button.

3. Give the integration a name (e.g. SkyStudio).

4. Choose which workspace to connect to.

5. Click the Submit button.

2. Copying the Token

After the integration is created, view and copy the token starting with secret_ in the Internal Integration Token field using the Show button.

Note: Keep this token safe. Even if you lose it, you can always view it again at notion.so/my-integrations.

3. Sharing pages and databases via integration

Creating an integration in Notion is not enough on its own. Sharing must be done separately for each page or database that needs to be accessed.

1. In Notion, open the page or database you wish to access.

2. Click the ... (three dots) menu in the upper right corner.

3. Select the Connections (or Add connections) option.

4. Find and click the integration you created (e.g., SkyStudio) in the list.

Note: When you grant access to a parent page, all subpages and databases below that page also become accessible automatically.

Adding a Connection in SkyStudio​

1. Go to the Application Connections section from the left-hand menu of SkyStudio.

2. Click the Add New Connection button.

3. Select Notion as your provider.

4. Enter a descriptive name in the Connection Name field (e.g., Prod Notion).

5. Paste the secret_… token you copied into the Integration Token field.

6. Click the Save button.

Assigning the Connection to the Node​

After adding the Notion node to the canvas, select the saved link from the Application Connections drop-down menu in the right panel.

Operations​

The Notion node offers 8 operations:

Database Query​

Notion queries records in a database with filtering and sorting options. It is used in database-based applications such as CRM, task tracking, or content calendars.

Parameters​

How to Find the Database ID?​

Open the database in Notion. The structure in the URL is: notion.so/{workspace}/{database-id}?v=...

The Database ID is the 32-character section before the ?v= part in the URL. Alternatively, the ID can be used from a copied link obtained by selecting the Copy link option from the ... menu on the database page.

Sample Output​

{
  "results": [
    {
      "id": "page-id-123",
      "properties": {
        "Name": { "title": [{ "plain_text": "Project Meeting" }] },
        "Status": { "select": { "name": "In Progress" } },
        "Due Date": { "date": { "start": "2024-06-01" } }
      }
    }
  ]
}

Notion AI Assistant​

It queries Notion content using natural language. It's ideal for accessing page and database analysis without writing complex filters.

Parameters​

Usage Example​

Query: "What tasks need to be completed this week?"

System Prompt: "Only consider records from the 'Tasks' database. List the results in Turkish and in order of priority."

List Pages​

Lists the pages in the Notion workspace. Used to discover Page IDs and create a page inventory.

Parameters​

Sample Output​

{
  "results": [
    {
      "id": "abc123",
      "properties": {
        "title": [{ "plain_text": "Product Roadmap" }]
      },
      "url": "https://notion.so/abc123"
    }
  ]
}

Get Page​

Returns the metadata (title, creation date, last modified date, attributes) of a specific Notion page. It does not retrieve the block content of the page; use the Fetch Page Content operation for that.

Parameters​

Get Page Content​

Returns the block content (text, headings, lists, tables, etc.) of a specific Notion page. Used in scenarios for reading and summarizing page content.

Parameters​

Sample Output​

{
  "results": [
    {
      "type": "heading_1",
      "heading_1": { "rich_text": [{ "plain_text": "Project Summary" }] }
    },
    {
      "type": "paragraph",
      "paragraph": { "rich_text": [{ "plain_text": "The aim of this project is..." }] }
    }
  ]
}

List Databases​

Lists all Notion databases in the Workspace. Used to discover database IDs.

Parameters​

Create Page​

Creates a new Notion page below the specified parent page or database.

Parameters​

Sample Output​

{
  "id": "new-page-id-456",
  "url": "https://notion.so/new-page-id-456",
  "properties": {
    "title": [{ "plain_text": "Weekly Report - June 2024" }]
  }
}

Add Content​

Adds new content (block) to the end of an existing Notion page. Used in page logging and automated content accumulation workflows.

Parameters​

Common Errors​

Notes​

• The Notion Integration Token (secret_…) does not expire; however, if the integration is deleted or the token is renewed, you will need to update your SkyStudio connection.
• The List Pages and List Databases operations only return content shared via integration. Pages that are not shared will not be listed.
• Fetch Page retrieves the page's metadata (title, date, attributes), while Fetch Page Content retrieves the block content. These are two different operations and are not interchangeable.
• In the Create Page operation, if database is selected for the Parent Type field, the created page is added to the database as a row; if page is selected, it is added as a subpage.
• For large (multi-block) page content, the Fetch Page Content operation can be time-consuming; consider truncating or filtering the content before sending it to the LLM node.

HubSpot Node​

The HubSpot node enables integration with HubSpot CRM in SkyStudio workflows. You can read, filter, and run AI-powered queries on contact, deal, and company records.

Connection Setup and Management​

To use the HubSpot node, you need to create a Private App on HubSpot and add the access token to SkyStudio.

Obtaining Private App Tokens​

1. Log in to your HubSpot account.

2. Go to Settings from the profile icon in the upper right corner.

3. Open Integrations → Private Apps from the left menu.

4. Click the Create Application button.

5. Give the application a name and select the necessary permission scopes:

• CRM → crm.objects.contacts.read, crm.objects.deals.read, crm.objects.companies.read

6. Click the Create Application button.

7. Copy the generated Access Token (starting with pat-eu1-… or pat-na1-…).

Note: The token can only be displayed fully once. If you forget to copy it, you will need to regenerate the token.

Adding a Connection in SkyStudio​

1. Go to the Application Connections section from the left-hand menu of SkyStudio.

2. Click the Add New Connection button.

3. Select HubSpot as your provider.

4. Enter a descriptive name in the Link Name field (e.g., Prod HubSpot).

5. Paste the token you copied into the Private App Access Token field.

6. Click the Save button.

Assigning the Connection to the Node​

After adding the HubSpot node to the canvas, select the saved link from the Application Connections drop-down menu in the right panel.

Note: You can define separate links for different HubSpot portals (e.g., test and live) and choose which one to use in your workflow.

Operations​

The HubSpot node offers 7 operations:

Get Contacts​

Returns all contact records from HubSpot CRM. Used in bulk contact list retrieval and synchronization scenarios.

Parameters​

Properties Examples​

firstname, lastname, email, phone, company, jobtitle, city, country, createdate, lastmodifieddate, hubspot_owner_id

Sample Output​

{
  "results": [
    {
      "id": "12345",
      "properties": {
        "firstname": "Ahmet",
        "lastname": "Yılmaz",
        "email": "ahmet@sirket.com",
        "phone": "+905551234567",
        "company": "Örnek A.Ş."
      }
    }
  ]
}

Get Deals​

It returns all deal records from HubSpot CRM. It is used in sales pipeline tracking and reporting workflows.

Parameters​

Properties Examples​

dealname, amount, dealstage, closedate, pipeline, hubspot_owner_id, createdate, hs_lastmodifieddate

Sample Output​

{
  "results": [
    {
      "id": "67890",
      "properties": {
        "dealname": "Corporate License - Example Inc.",
        "amount": "15000",
        "dealstage": "presentationscheduled",
        "closedate": "2024-12-31T00:00:00.000Z"
      }
    }
  ]
}

Object Search​

In HubSpot CRM, it searches for any object type (person, opportunity, company, ticket, etc.) using a specific filter. It is used for dynamic queries and conditional data retrieval scenarios.

Parameters​