- Getting started
- Notifications
- Troubleshooting
- Connector Builder
- ActiveCampaign
- Active Directory - Preview
- Adobe Acrobat Sign
- Adobe PDF Services
- Amazon Bedrock
- Amazon Connect
- Amazon Polly
- Amazon SES
- Amazon Transcribe
- Amazon Web Services
- Anthropic Claude
- Asana
- AWeber
- Azure AI Document Intelligence
- Azure Maps
- BambooHR
- Box
- Brevo
- Calendly
- Campaign Monitor
- Cisco Webex Teams
- Citrix ShareFile
- Clearbit
- Confluence Cloud
- Constant Contact
- Coupa
- Customer.io
- Datadog
- Deputy
- Discord
- DocuSign
- Drip
- Dropbox
- Egnyte
- Eventbrite
- Exchangerates
- Exchange Server - Preview
- Expensify
- Facebook
- Freshbooks
- Freshdesk
- Freshservice
- GetResponse
- GitHub
- Gmail
- Google Cloud Platform
- Google Docs
- Google Drive
- Google Maps
- Google Sheets
- Google Speech-to-Text
- Google Text-to-Speech
- Google Tasks - Preview
- Google Vertex
- Google Vision - Preview
- Google Workspace - Preview
- GoToWebinar
- Greenhouse
- HTTP Webhook - Preview
- Hubspot CRM
- HubSpot Marketing
- HyperV - Preview
- iContact
- Insightly CRM
- Intercom
- Jira
- Keap
- Klaviyo
- LinkedIn
- Mailchimp
- Mailgun
- Mailjet
- MailerLite
- Marketo
- Microsoft 365
- Microsoft Azure
- Microsoft Azure Active Directory
- Microsoft Azure OpenAI
- Microsoft Dynamics 365 CRM
- Microsoft OneDrive & Sharepoint
- Microsoft Outlook 365
- Microsoft Sentiment
- Microsoft Teams
- Microsoft Translator
- Microsoft Vision
- Miro
- Okta
- OpenAI
- Oracle Eloqua
- Oracle NetSuite
- PagerDuty
- PayPal
- PDFMonkey
- Pinecone
- Pipedrive
- QuickBooksOnline
- Quip
- Salesforce
- Salesforce Marketing Cloud
- SAP BAPI - Preview
- SAP Concur
- SendGrid
- ServiceNow
- Shopify
- Slack
- SmartRecruiters
- Smartsheet
- Stripe
- Sugar Enterprise
- Sugar Professional
- Sugar Sell
- Sugar Serve
- System Center - Preview
- TangoCard
- Todoist
- Trello
- Twilio
- X (formerly Twitter)
- Xero
- watsonx.ai
- WhatsApp Business
- WooCommerce
- Workable
- Workday
- YouTube
- Zendesk
- Zoho Campaigns
- Zoho Desk
- Zoho Mail
- ZoomInfo
Building your first connector
This section explains how to create a connector using Connector Builder and use it within an automation. The example covers creating a connector through a manual process, so we automatically address points that can otherwise typically be skipped.
The workflow we are designing is meant to receive daily Slack messages of stock prices that are of interest. Polygon.io provides a set of free APIs that retrieve stock information and can be used for our purpose. They have a quick sign up process that, in return, provides us with an API key to make the API calls that we need to make.
You can also check out the Building your connector from an API definition section. This explains how to import a Swagger definition and let Connector Builder complete most of the work for you.
Most vendor applications require authentication details in the form of username and password, OAuth App, API key, etc. Polygon.io is no different. It provides a free sign up to try out some of their APIs.
- Go to polygon.io and create an account.
- Open your Dashboard and select API Keys to view your key.
Within Automation CloudTM Public Sector, navigate to Integration Service and select Build your connector.
Let's start with A blank connector. If you have any form of API definition at hand (Swagger, YAML, etc.), you can select Start from API definition and let Connector Builder do most of the configuration work for you.
-
Download the
polygon.svg
icon from the web to add their logo to your catalog.Note:All image types are supported, but we recommend using a square SVG.
-
Add a name and description for your custom connector, then select Create.
The Polygon Getting started documentation references that any API call to their platform requires you to send your API key in the headers or as a query parameter. To do this, you need to add it into the headers, as explained in the following example:
- Pass your API key in the query string as follows, where
<your_token>
is the API key:https://api.polygon.io/v2/aggs/ticker/AAPL/range/1/day/2023-01-09/2023-01-09?apiKey=<your_token>
https://api.polygon.io/v2/aggs/ticker/AAPL/range/1/day/2023-01-09/2023-01-09?apiKey=<your_token> - Alternatively, you can add an Authorization header to the request with your API Key as the token, in the following form, where
<your_token>
is the API key:Authorization: Bearer <your_token>
Authorization: Bearer <your_token> - In Connector Builder, navigate to Settings and select the Base API tab. Set the Base URL to
https://api.polygon.io
.Note: In this example, we do not add theversion "v2"
section to the Base URL. This allows us to run some of the older stock API calls. - Next, go to the Authentication tab to select your preferred Authentication type from the drop-down list. For this example, let's select Personal Access Token (PAT).
Note:
The Polygon documentation refers to an API key, but given that it has to be sent as Authorization: Bearer <your_token>, it is actually closer to an OAuth style token. Therefore, Personal Access Token (PAT) is technically the better definition. Read more about the different Authentication types.
- Copy your API key from Polygon and set the Value as:
Bearer <your_key>
. - Set the Ask the user field to No, so that users are not asked for their key when creating a connection to this connector. This is because we are not going
to share this connector beyond our tenant. If, however, you want to share the connector beyond the tenant, don’t add your
own key. Set Ask the user to Yes, so that other users are prompted to subscribe to the Polygon service themselves.
The preconfigured authentication types in Connector Builder take care of most of the work for you. For example, Personal Access Token automatically sends Authorization: Bearer <your_token> as an auth header, rather than you having to build this configuration yourself.
- Set up a connection with the above configuration by selecting the Not connected > Add connection button. Notice how this already works as any other Integration Service connector. Select Connect so that you have a test connection to make API calls to.
After establishing a connection to the third-party software, we move on to performing the actual API calls.
- Navigate to the left-side panel to API > Create new resource group. The goal is to get a daily Slack notification on the opening price of a given stock. The endpoint we are going to implement
now is Polygon's Daily open/close API.
- In the Create new resource group window, copy the endpoint information from the Polygon docs.
- Set the Path to
/open-close/{stocksTicker}/{date}
. - From the Select methods list, enable Get record (GETBYID), since we select a single object, rather than an array of objects.
- Provide a display name, such as Open - Close for stock. Connector Builder will automatically convert the
{x}
variables to path variables. - Select Create to add this resource.
- To test if the setup is working, select the Send request button next to your resource. This creates values for the two path parameters. We can take them from the usage example in
the Polygon docs.
DateTime
and provide the mask as example. Providing Display names makes your connector show up better within the Studio activity. You can see an example in the following screenshot
As the final step, select Publish to publish your connector to your tenant. The connector appears in the list of connectors featured on your tenant, and anyone that is using the same tenant can see and use the Polygon connector.
Having a connector appear in Integration Service is only relevant if you can actually use it in a workflow.
To test your custom connector in a workflow:
- Open UiPath Studio and create a new project. For example, Slack daily stock prices. Since we want to receive daily messages, the first activity used in this workflow is a Time Trigger.
- Next, when you drag a Polygon activity to the canvas, you are prompted to connect to Polygon.io with your account.
- Once a connection is established, configure the Polygon activity to retrieve information on Apple stocks (AAPL). You can hard code the stock you are interested in, but you must format the date to be the runtime date.
- Next, add a Slack Send Message to Channel activity to send this info to a channel. If you want to send the information to yourself, use Send Message to User.