Discovery connector request nodes
You can use discovery connector request nodes to connect to an application endpoint and issue requests to complete actions on business objects, such as retrieving customer details or creating new contacts.
When you use a discovery connector request node in a message flow, the behavior of the flow depends on the actions that you set when you configured the node during discovery and on the availability of any objects that you want to retrieve or update. Note that the maximum file size that can be processed by a discovery connector request node is 10 MB. For more information, see Discovery connector request node actions and behavior.
For some objects and actions that you configure on a connector discovery request node, you must populate the data that will be sent to the third-party endpoint system to which you are connecting from the node. In order to populate that data, you can either use mapping during the connector discovery process to build the input message from values that you select, or you can use a message that is propagated by a previous node in the flow, such as a Compute, JavaCompute, or Mapping node:
- Using mapping during connector discovery:
- Discovery connector request nodes provide a JSONata mapping capability, which you can use to map
data between nodes in a message flow without requiring a separate transformation node in the flow.
You can use this built-in mapping capability to map JSON data by setting static values or
configuring JSONata expressions on the request node.
You use mapping during connector discovery to build the input message by configuring the Map Inputs table in the Request tab of the node. You use this table to specify information about the data locations and schemas of the input data that can be used when building the message. After you have configured the connection details for the connector in the Connector Discovery wizard, a panel is displayed in which you can configure the request properties and the payload fields. You can populate these fields either by setting static values or by using a JSONata expression to select input data from any of the available inputs that are configured in the Map Inputs table.
For more information about using JSONata mapping, see Configuring mapping for discovery connector request nodes.
- Taking the input message from a previous node in the flow:
- As an alternative to configuring a map during connector discovery, you can choose to take the input message from a previous node in the flow without applying any mapping logic. You configure the connector to take its input data from the location that is defined in the Data location field, by selecting the Using Data location property on the connector during connector discovery. As no mapping logic is applied to this input data, it must match the request schema of the connector. By default, when the input message is propagated from a previous node in the flow, before the request node is invoked, the content of the input message is validated by using the request schema. You can control this validation by using the properties on the Validation tab of the request node.
You can use filter properties on a discovery connector request node to control the way in which the message flow selects data. The initial values of these properties are taken from the property values that are set for the connector in the Connector Discovery wizard, including the filter options properties and any conditions that are specified. If you subsequently return to the Connector Discovery wizard and change the values of any properties (by adding new conditions, for example) those updates are reflected in the properties set on the node. You can use the filter options properties to control which objects are to be operated upon when the node executes. Filter limit properties control the maximum number of items to be retrieved and the action to be taken if the limit is exceeded. The property values can be either text values or ESQL or XPATH expressions that are resolved from the contents of the message passed to the node as it executes.
For more information about discovery connector nodes, see Discovery connector nodes. For information about the discovery connector input nodes that are provided by IBM App Connect Enterprise, see Discovery connector input nodes.
The following discovery connector request nodes are provided with IBM App Connect Enterprise:
- Amazon CloudWatch Request node
-
Use the Amazon CloudWatch Request node to connect to Amazon CloudWatch and issue requests to perform actions on objects such as composite alarms, log events, metrics, and export tasks.
- Amazon DynamoDB Request node
-
Use the Amazon DynamoDB Request node to connect to Amazon DynamoDB and issue requests to perform actions on objects such as backups, items, regions, tables, and tags.
- Amazon EC2 Request node
-
Use the Amazon EC2 Request node to connect to Amazon EC2 and issue requests to perform actions on objects such as Amazon machine images, availability zones, instances, key pairs, launch templates, and security groups.
- Amazon EventBridge Request node
-
Use the Amazon EventBridge Request node to connect to Amazon EventBridge and issue requests to send events or to create, retrieve, or delete event buses.
- Amazon Kinesis Request node
-
Use the Amazon Kinesis Request node to connect to Amazon Kinesis and issue requests to perform actions on objects such as applications, data streams, data stream records, delivery streams, shards, and tags.
- Amazon RDS Request node
-
Use the Amazon RDS Request node to connect to Amazon RDS and issue requests to perform actions on objects such as database clusters, database instances, database snapshots, exports, and tags.
- Amazon SES Request node
-
Use the Amazon SES Request node to connect to Amazon SES and issue requests to perform actions on objects such as contacts, contact lists, configuration sets, emails, email identities, and email templates.
- Amazon SNS Request node
-
Use the Amazon SNS Request node to connect to Amazon SNS and issue requests to perform actions on objects such as subscriptions, tags, and topics.
- Amazon SQS Request node
-
Use the Amazon SQS Request node to connect to Amazon SQS and issue requests to perform actions on objects such as messages, queues, and tags.
- Amazon S3 Request node
-
You can use the Amazon S3 Request node to connect to Amazon S3 and issue requests to create, retrieve, update, delete, or view buckets and other objects.
- Anaplan Request node
-
Use the Anaplan Request node to connect to Anaplan and issue requests to perform actions on objects such as files, cell data, list items, processes, imports, and exports.
- Apptio Targetprocess Request
-
Use the Apptio Targetprocess Request node to connect to Apptio Targetprocess and issue requests to create, update, or retrieve objects such as bugs, comments, epics, features, projects, tasks, users, and user stories.
- Asana Request node
-
Use the Asana Request node to connect to Asana and issue requests to create, retrieve, update, or delete objects such as projects, tasks, stories, and workspaces.
- AWS Lambda Request node
-
Use the AWS Lambda Request node to connect to AWS Lambda and issue requests to create, retrieve, update, delete, or invoke functions.
- BambooHR Request node
-
Use the BambooHR Request node to connect to BambooHR and issue requests to perform actions on objects such as employees, employee dependents, employee files, benefit deduction types, custom reports, list fields, and time tracking records.
- Box Request node
-
Use the Box Request node to connect to Box and issue requests to create, retrieve, update, and delete objects such as files, folders, bookmarks, and comments.
- Businessmap Request node
-
Use the Businessmap Request node to connect to Businessmap and issue requests to perform actions on objects such as teams, workspaces, boards, cards, and users.
- Calendly Request node
-
Use the Calendly Request node to connect to Calendly and issue requests to create, retrieve, and update objects such as expense reports, exchange rates, and invoices.
- ClickSend Request node
-
Use the ClickSend Request node to connect to ClickSend and issue requests to perform actions on objects such as accounts, contacts, and SMS campaigns.
- CMIS Request node
-
Use the CMIS Request node to connect to CMIS and issue requests to perform actions on objects such as documents, folders, and repositories.
- Confluence Request node
-
Use the Confluence Request node to connect to Confluence and issue requests to create, retrieve, update, delete, download, or publish objects such as blog posts, pages, attachments, and comments.
- Coupa Request node
-
Use the Coupa Request node to connect to Coupa and issue requests to create, retrieve, and update objects such as expense reports, exchange rates, and invoices.
- Crystal Ball Request node
-
Use the Crystal Ball Request node to connect to Crystal Ball and issue requests to create, retrieve, update, or delete annotations.
- DocuSign Request node
-
Use the DocuSign Request node to connect to DocuSign and issue requests to create, retrieve, update, or delete objects such as documents, attachments, envelopes, and recipients.
- Dropbox Request node
-
Use the Dropbox Request node to connect to Dropbox and issue requests to retrieve files, folders, and paper docs, create, retrieve or revoke shared links, or download file content.
- Eventbrite Request node
-
Use the Eventbrite Request node to connect to Eventbrite and issue requests to create, retrieve, update, or delete objects such as events, attendees, contact lists, organizers, and orders.
- Expensify Request node
-
Use the Expensify Request node to connect to Expensify and issue requests to perform actions on objects such as receipts, expense reports, and vendor invoices.
- Factorial HR Request node
-
Use the Factorial HR Request node to connect to Factorial HR and issue requests to perform actions on objects such as absences, attendances, employees, and tasks.
- flexEngage Request node
-
Use the flexEngage Request node to connect to flexEngage and issue requests to create or retrieve order events.
- Front Request
- Use the Front Request node to connect to Front and issue requests to perform actions on objects such as accounts, channels, contacts, messages, and conversations.
- GitHub Request node
-
Use the GitHub Request node to connect to GitHub and issue requests to create, retrieve, update, delete, or merge objects such as branches, issues, organizations, pull requests, and repositories.
- GitLab Request node
-
Use the GitLab Request node to connect to GitLab and issue requests to perform actions on objects such as epics, issues, branches, milestones, pipelines, commits, and merge requests.
- Gmail Request node
-
Use the Gmail Request node to connect to Gmail and issue requests to send, delete, or retrieve emails, or update email labels.
- Google Analytics Request node
-
Use the Google Analytics Request node to connect to Google Analytics and issue requests to perform actions on objects such as custom data sources, custom metrics, filters, account user links, and goals.
- Google Calendar Request node
-
Use the Google Calendar Request node to connect to Google Calendar and issue requests to perform actions on objects such as calendars, calendar sharing, and events.
- Google Chat Request node
-
Use the Google Chat Request node to connect to Google Chat and issue requests to perform actions on objects such as members, messages, and spaces.
- Google Cloud BigQuery Request node
-
Use the Google Cloud BigQuery Request node to connect to Google Cloud BigQuery and issue requests to perform actions on objects such as datasets, jobs, tables, and views.
- Google Cloud PubSub Request node
-
Use the Google Cloud PubSub Request node to connect to Google Cloud Pub/Sub and issue requests to create, retrieve, update, or delete objects such as subscriptions, topics, and messages.
- Google Cloud Storage Request node
-
Use the Google Cloud Storage Request node to connect to Google Cloud Storage and issue requests to perform actions on objects such as buckets, bucket ACLs, object ACLs, and object versioning.
- Google Contacts Request node
-
Use the Google Contacts Request node to connect to Google Contacts and issue requests to perform actions on objects such as contacts and contact groups.
- Google Drive Request node
-
Use the Google Drive Request node to connect to Google Drive and issue requests to retrieve objects such as files, folders, revisions, and comments.
- Google Groups Request node
-
Use the Google Groups Request node to connect to Google Groups and issue requests to perform actions on objects such as groups, group members, and group aliases.
- Google Sheets Request node
-
Use the Google Sheets Request node to connect to Google Sheets and issue requests to create or retrieve objects such as spreadsheets, worksheets, and rows.
- Google Tasks Request node
-
Use the Google Tasks Request node node to connect to Google Tasks and issue requests to perform actions on objects such as tasks and task lists.
- Google Translate Request node
-
Use the Google Translate Request node to connect to Google Translate and issue requests to detect languages, retrieve locations, translate text, or translate documents.
- Greenhouse Request node
-
Use the Greenhouse Request node to connect to Greenhouse and issue requests to perform actions on objects such as applications, candidates, jobs, job posts, job stages, prospects, and scheduled interviews.
- HubSpot CRM Request node
-
Use the HubSpot CRM Request node to connect to HubSpot CRM and issue requests to perform actions on objects such as companies, contacts, deals, line items, owners, and products.
- HubSpot Marketing Request node
-
Use the HubSpot Marketing Request node to connect to HubSpot Marketing and issue requests to perform actions on objects such as contacts, contact lists, email campaigns, and marketing events.
- Hunter Request node
-
Use the Hunter Request node to connect to Hunter and issue requests to perform actions on objects such as leads, campaigns, emails, and domains.
- IBM Cloudant Request node
-
Use the IBM Cloudant Request node to connect to IBM Cloudant and issue requests to create, retrieve, update, delete, or view documents in a Cloudant database.
- IBM Cloud Object Storage S3 Request node
-
Use the IBM Cloud Object Storage S3 Request node to connect to IBM Cloud Object Storage S3 and issue requests to perform actions on objects such as CORS, buckets, and objects.
- IBM Engineering Workflow Management Request node
-
Use the IBM Engineering Workflow Management Request node to connect to IBM Engineering Workflow Management and issue requests to perform actions on objects such as attachments, project areas, URI resolvers, and work items.
- IBM FileNet Content Manager Request node
-
Use the IBM FileNet Content Manager Request node to connect to IBM FileNet Content Manager and issue requests to perform actions on objects such as documents and folders.
- IBM Food Trust Request node
-
Use the IBM Food Trust Request node to connect to IBM Food Trust and issue requests to perform actions on objects such as certificates, basic party registrations, EPCIS aggregation events, EPCIS object events, or purchase orders.
- IBM Maximo Request node
-
Use the IBM Maximo Request node to connect to IBM Maximo and issue requests to perform actions on objects such as assets, contracts, purchase orders, and service requests.
- IBM OpenPages with Watson Request node
-
Use the IBM OpenPages with Watson Request node to connect to IBM OpenPages with Watson and issue requests to create, retrieve, update, or delete objects such as business entities, controls, files, issues, and processes.
- IBM Sterling Inventory Visibility Request node
-
Use the IBM Sterling Inventory Visibility Request node to connect to IBM Sterling Inventory Visibility and issue requests to perform actions on objects such as demands, distribution groups, jobs, safety stocks, and supplies.
- IBM Supply Chain Intelligence Suite Request node
-
Use the IBM Supply Chain Intelligence Suite Request node to connect to IBM Supply Chain Intelligence Suite and issue requests to perform actions on objects such as catalogs, demand plans, inventories, orders, and products.
- IBM Watson Discovery Request node
-
Use the IBM Watson Discovery Request node to connect to IBM Watson Discovery and issue requests to create, retrieve, update, delete, or add documents.
- IBM watsonx.ai Request node
-
Use the IBM watsonx.ai Request node to connect to IBM watsonx.ai and issue requests to perform actions on objects such as text, emails, summaries, and foundation models.
- IBM Weather Company Data Limited Edition Request node
-
Use the IBM Weather Company Data Limited Edition Request node to connect to IBM Weather Company Data Limited Edition and issue requests to perform actions on objects such as current conditions, forecasts, and historical observations.
- Infobip Request node
-
Use the Infobip Request node to connect to Infobip and issue requests to perform actions on objects such as accounts, entities, WhatsApp templates, SMS messages, and voice messages.
- Insightly Request node
-
Use the Insightly Request node to connect to Insightly and issue requests to perform actions on objects such as contacts, events, leads, opportunities, or tasks.
- Jenkins Request node
-
Use the Jenkins Request node to connect to Jenkins and issue requests to perform actions on objects such as builds and projects.
- Jira Request node
-
Use the Jira Request node to connect to Jira and issue requests to create, retrieve, update, or delete objects such as projects, issues, filters, and users.
- LDAP Request node
-
Use the LDAP Request node to connect to LDAP and issue requests to create, retrieve, update, or delete objects such as devices, entries, organization units, persons, and rooms.
- Magento Request node
-
Use the Magento Request node to connect to Magento and issue requests to perform actions on objects such as customers, products, sales invoices, and orders.
- MailChimp Request node
-
Use the MailChimp Request node to connect to MailChimp and issue requests to create, retrieve, or delete objects such as campaigns, campaign folders, campaign reports, files, folders, and interests.
- Marketo Request node
-
Use the Marketo Request node to connect to Marketo and issue requests to create, retrieve, update, or delete objects such as campaigns, leads, lists, or opportunities.
- Microsoft Active Directory Request node
-
Use the Microsoft Active Directory Request node to connect to Microsoft Active Directory and issue requests to perform actions on objects such as computers, contacts, entries, groups, organizational units, and users.
- Microsoft Azure Blob Storage Request node
-
Use the Microsoft Azure Blob Storage Request node to connect to Microsoft Azure Blob storage and issue requests to perform actions on objects such as blobs and containers.
- Microsoft Dynamics 365 for Finance and Operations Request node
-
Use the Microsoft Dynamics 365 for Finance and Operations Request node to connect to Microsoft Dynamics 365 for Finance and Operations and issue requests to create, retrieve, update, or delete objects such as applicants, customers, employees, operations, projects, prospects, sales agreements, user groups, and vendors.
- Microsoft Dynamics 365 for Sales Request node
-
Use the Microsoft Dynamics 365 for Sales Request node to connect to Microsoft Dynamics 365 for Sales and issue requests to create, retrieve, update, or delete accounts, contacts, invoices, leads, orders, and products.
- Microsoft Entra ID Request node
-
Use the Microsoft Entra ID Request node to connect to Microsoft Entra ID and issue requests to create, retrieve, update, or delete objects such as devices, groups, and users.
- Microsoft Excel Online Request node
-
Use the Microsoft Excel Online Request node to connect to Microsoft Excel Online and issue requests to perform actions on objects such as tables, rows, columns, ranges, workbooks, and worksheets.
- Microsoft Exchange Request node
-
Use the Microsoft Exchange Request node to connect to Microsoft Exchange and issue requests to perform actions on objects such as attachments, calendars, contacts, conversations, emails, groups, mail folders, organizations, and users.
- Microsoft OneDrive for Business Request node
-
Use the Microsoft OneDrive for Business Request node to connect to Microsoft OneDrive for Business and issue requests to perform actions on objects such as drives, files, folders, folder items, permissions, shared links, and users.
- Microsoft OneNote Request node
-
Use the Microsoft OneNote Request node to connect to Microsoft OneNote and issue requests to perform actions on objects such as pages, notebooks, sections, and section groups.
- Microsoft Power BI Request node
-
Use the Microsoft Power BI Request node to connect to Microsoft Power BI and issue requests to perform actions on objects such as datasets, gateway data sources, goals, push datasets, and workspaces.
- Microsoft SharePoint Request node
-
Use the Microsoft SharePoint Request node to connect to Microsoft SharePoint and issue requests to perform actions on objects such as files, folders, folder items, lists, list items, list item attachments, sites, and users.
- Microsoft Teams Request node
-
Use the Microsoft Teams Request node to connect to Microsoft Teams and issue requests to perform actions on objects such as channels, chats, groups, members, messages, owners, teams, and users.
- Microsoft To Do Request node
-
Use the Microsoft To Do Request node to connect to Microsoft To Do and issue requests to perform actions on objects such as lists, tasks, checklist items, or file attachments.
- Microsoft Viva Engage Request node
-
Use the Microsoft Viva Engage Request node to connect to Microsoft Viva Engage and issue requests to perform actions on objects such as files, groups, messages, topics, and users.
- monday.com Request node
-
Use the monday.com Request node to connect to monday.com and issue requests to perform actions on objects such as boards, item files, items, subitems, and users.
- Oracle E-Business Suite Request node
-
Use the Oracle E-Business Suite Request node to connect to Oracle E-Business Suite and issue requests to create, get, update, or delete objects such as customers, orders, deliveries, invoices, and receipts.
- Oracle Human Capital Management Request node
-
Use the Oracle Human Capital Management Request node to connect to Oracle Human Capital Management and issue requests to create, retrieve, update, or delete objects such as absence records, candidates, job requisitions, payrolls, and time records.
- Salesforce Account Engagement Request node
-
Use the Salesforce Account Engagement Request node to connect to Salesforce Account Engagement and issue requests to perform actions on objects such as prospects, users, and visitors.
- Salesforce Commerce Cloud Digital Data Request node
-
Use the Salesforce Commerce Cloud Digital Data Request node to connect to Salesforce Commerce Cloud Digital Data and issue requests to perform actions on objects such as campaigns, catalogs, customers, inventory lists, products, site promotions, and stores.
- Salesforce Marketing Cloud Request node
-
Use the Salesforce Marketing Cloud Request node to connect to Salesforce Marketing Cloud and issue requests to perform actions on objects such as assets, campaigns, contacts, event definitions, journeys, and locations.
- Salesforce Request node
-
Use the Salesforce Request node to connect to Salesforce and issue requests to perform actions on objects such as accounts, campaigns, contacts, leads, and orders.
- SAP Ariba Request node
-
Use the SAP Ariba Request node to connect to SAP Ariba and issue requests to perform actions on objects such as contract workspaces, organizations, sourcing projects, suppliers, and users.
- SAP OData Request node
-
Use the SAP OData Request node to connect to SAP and issue requests to create, retrieve, update, or delete SAP OData resources.
- SAP SuccessFactors Request node
-
Use the SAP SuccessFactors Request node to connect to SAP SuccessFactors and issue requests to perform actions on objects such as job applications, job application interviews, job requisitions, candidates, and onboarding candidate information.
- ServiceNow Request node
-
Use the ServiceNow Request node to connect to ServiceNow and issue requests to create, retrieve, update, download, and delete objects such as assets, incidents, and tickets.
- Shopify Request node
-
Use the Shopify Request node to connect to Shopify and issue requests to perform actions on objects such as customers, inventory items, orders, products, and transactions.
- Slack Request node
-
Use the Slack Request node to connect to Slack and issue requests to send or retrieve messages, or to add, delete, or retrieve objects such as files, channels, users, and groups.
- Snowflake Request node
-
Use the Snowflake Request node to connect to Snowflake and issue requests to perform actions on objects such as custom SQL queries, pipes, rows, stages, stored procedures, tables, and tasks.
- Square Request node
-
Use the Square Request node to connect to Square and issue requests to perform actions on objects such as customers, invoices, orders, and payments.
- SurveyMonkey Request node
-
Use the SurveyMonkey Request node to connect to SurveyMonkey and issue requests to perform actions on objects such as collectors, contact lists, and surveys.
- Toggl Track Request node
-
Use the Toggl Track Request node to connect to Toggl Track and issue requests to create, retrieve, update, or delete objects such as clients, workspaces, tags, and time entries.
- Trello Request node
-
Use the Trello Request node to connect to Trello and issue requests to create, retrieve, update, or delete objects such as actions, boards, cards, checklists, and teams.
- Twilio Request node
-
Use the Twilio Request node to connect to Twilio and issue requests to perform actions on objects such as calls, incoming phone numbers, messages, and message services.
- UKG Request node
-
Use the UKG Request node to connect to UKG (Ultimate Kronos Group) and issue requests to retrieve, reset, or create objects such as attendance records, employee schedules, job preferences, people, and leave records.
- WordPress Request node
-
Use the WordPress Request node to connect to WordPress and issue requests to perform actions on objects such as authors, blogs, comments, feeds, followers, posts, site statistics and more.
- Wrike Request
-
Use the Wrike Request node to connect to Wrike and issue requests to perform actions on objects such as approvals, comments, tasks, time logs, and work schedules.
- Wufoo Request node
-
Use the Wufoo Request node to connect to Wufoo and issue requests to perform actions on objects such as forms, form entries, reports, and users.
- Yapily Request node
-
Use the Yapily Request node to connect to Yapily and issue requests to perform actions on objects such as account statements, applications, authorization requests, institutions, payments, and transactions.
- Zendesk Service Request node
-
Use the Zendesk Service Request node to connect to Zendesk Service and issue requests to create, retrieve, update, or delete objects such as articles, tickets, ticket attachments, and users.
- Zoho Books Request node
-
Use the Zoho Books Request node to connect to Zoho Books and issue requests to perform actions on objects such as customers, invoices, expenses, charts of accounts, items, and quotes.
- Zoho CRM Request node
-
Use the Zoho CRM Request node to connect to Zoho CRM and issue requests to create, retrieve, or convert objects such as accounts, campaigns, contacts, deals, and leads.
- Zoho Inventory Request node
-
Use the Zoho Inventory Request node to connect to Zoho Inventory and issue requests to perform actions on objects such as sales orders, contacts, purchase orders, and warehouses.
- Zoho Recruit Request node
-
Use the Zoho Recruit Request node to connect to Zoho Recruit and issue requests to perform actions on objects such as applications, candidates, job openings, users, and departments.