Configuring Connections
Configure Celigo connections and iClients -- credential and configuration objects that authenticate to external systems. Use when creating or editing connections, choosing auth methods, setting up OAuth, managing iClients (shared credential stores), or troubleshooting connectivity.
- Skill ID
- celigo/ai/configuring-connections
- Publisher
- celigo
- Repository
- ai
- Installs
- 0
- Files
- 28
- Synced
- Sep 23, 2026
Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.
celigo/ai/configuring-connectionsInstalls these files- SKILL.md
- references/iclient-schemas/base.yml
- references/iclient-schemas/ebay.yml
- references/iclient-schemas/netsuite.yml
- references/iclient-schemas/oauth2.yml
- references/iclient-schemas/request.yml
- references/iclient-schemas/response.yml
- references/iclient-schemas/salesforce.yml
- references/schemas/as2.yml
- references/schemas/dynamodb.yml
- references/schemas/filesystem.yml
- references/schemas/ftp.yml
- references/schemas/http.yml
- references/schemas/jdbc.yml
- references/schemas/jwt.yml
- references/schemas/mcp.yml
- references/schemas/mongodb.yml
- references/schemas/netsuite.yml
- references/schemas/oauth.yml
- references/schemas/rdbms.yml
- references/schemas/request.yml
- references/schemas/response.yml
- references/schemas/rest.yml
- references/schemas/s3.yml
- references/schemas/salesforce.yml
- references/schemas/ssl.yml
- references/schemas/van.yml
- references/schemas/wrapper.yml
What this skill tells the agent
<!-- TIER:1 -->
Configuring Connections
A connection is a credential and configuration object that lets Celigo communicate with an external system. Every export and import references a connection via _connectionId. Connections must be created before the resources that use them.
Concerns when configuring a connection:
- Authentication -- choosing the right auth method (OAuth, token, basic, key-pair, certificate, etc.) and providing the correct credentials
- Concurrency -- how many parallel requests Celigo can make to the target system (
concurrencyLevel). Can be shared across connections via_borrowConcurrencyFromConnectionId - Health monitoring -- ping configuration to verify connectivity and detect credential expiration (
offlinestatus) - Pre-built connectors -- HTTP connectors and trading partner connectors provide pre-configured auth, base URLs, and endpoint definitions for 550+ applications
- Debug logging -- temporary debug mode to capture raw request/response data for troubleshooting
- iClients -- reusable OAuth credential stores (client ID/secret, scopes, token endpoints) shared across connections. See iClients section below.
Used across flows, APIs, and tools.
Connection Types
| Target System | type | Schema | Notes |
|---|---|---|---|
| REST/GraphQL API (with connector) | http | http.yml | formType: "assistant", set _httpConnectorId |
| REST/GraphQL API (manual) | http | http.yml | Three form types: assistant, http, graph_ql |
| NetSuite ERP | netsuite | netsuite.yml | Use token-auto for new connections |
| Salesforce CRM | salesforce | salesforce.yml | Use packagedOAuth: true for new connections |
| SQL Server, MySQL, Postgres, Oracle | rdbms | rdbms.yml | |
| Snowflake, BigQuery, Redshift | rdbms | rdbms.yml | Check sub-type in schema |
| Active Directory, Databricks, DB2 | jdbc | jdbc.yml | |
| MongoDB/Atlas | mongodb | mongodb.yml | |
| DynamoDB | dynamodb | dynamodb.yml | |
| FTP/SFTP/FTPS server | ftp | ftp.yml | Optional PGP encryption |
| Amazon S3 | s3 | s3.yml | |
| Local filesystem | filesystem | filesystem.yml | Requires agent via _agentId |
| AS2 EDI partner | as2 | as2.yml | |
| Celigo VAN (EDI hub) | van | van.yml | |
| AI tool server (MCP) | mcp | mcp.yml | |
| Stack-deployed connector | wrapper | wrapper.yml | |
| Legacy REST (do not use) | rest | rest.yml | Use http instead |
Quick Reference
Connection Type Decision Matrix
| Target system | Use type | Auth method | Read schema |
|---|---|---|---|
| Any REST/GraphQL API with a Celigo connector | http | Connector-defined (usually OAuth2 or token) | http.yml |
| Any REST/GraphQL API without a connector | http | Token, basic, OAuth2, custom headers | http.yml |
| NetSuite ERP | netsuite | token-auto (Celigo-managed TBA) | netsuite.yml |
| Salesforce CRM | salesforce | packagedOAuth: true (Celigo OAuth) | salesforce.yml |
| SQL databases (Postgres, MySQL, SQL Server, Oracle) | rdbms | Username/password + host/port | rdbms.yml |
| Snowflake / BigQuery / Redshift | rdbms | Key-pair or username/password | rdbms.yml |
| MongoDB / Atlas | mongodb | Connection string or host/credentials | mongodb.yml |
| FTP / SFTP / FTPS | ftp | Username/password or SSH key | ftp.yml |
| Amazon S3 | s3 | IAM access key or role ARN | s3.yml |
| MCP server | mcp | Varies (OAuth2 or token) | mcp.yml |
Which of the two HTTP rows applies is determined by search, not preference: check for a pre-built connector first (celigo http-connectors list) and use the manual row only when no connector exists or it doesn't fit -- see Check for a pre-built connector and global iClient.
Minimum Required Fields
Every connection needs at minimum: name, type, and the type-specific config block.
| Type | Required fields |
|---|---|
http (connector) | name, type: "http", http._httpConnectorId, http._httpConnectorVersionId, connector-specific auth fields |
http (manual) | name, type: "http", http.baseURI, http.auth.type, auth credentials |
netsuite | name, type: "netsuite", netsuite.account, netsuite.environment, netsuite.authType: "token-auto", netsuite._iClientId |
salesforce | name, type: "salesforce", salesforce.sandbox (boolean), salesforce.packagedOAuth: true |
rdbms | name, type: "rdbms", rdbms.host, rdbms.port, rdbms.database, rdbms.user, rdbms.password |
ftp | name, type: "ftp", ftp.host, ftp.port, ftp.username, auth (password or key) |
s3 | name, type: "s3", s3.region, s3.bucket, IAM credentials |
mongodb | name, type: "mongodb", mongodb.host or mongodb.connectionString |
Which Schemas to Read
Rule: Always read the base request.yml for shared fields, then the type-specific schema for the connection type you are configuring.
Schema Index
Connection schemas (in references/schemas/):
- Base fields (all connections): request.yml
- Response shape: response.yml
- HTTP: http.yml
- NetSuite: netsuite.yml
- Salesforce: salesforce.yml
- RDBMS: rdbms.yml
- JDBC: jdbc.yml
- MongoDB: mongodb.yml
- DynamoDB: dynamodb.yml
- FTP: ftp.yml
- S3: s3.yml
- Filesystem: filesystem.yml
- AS2: as2.yml
- VAN: van.yml
- MCP: mcp.yml
- Wrapper: wrapper.yml
- REST (legacy): rest.yml
- OAuth: oauth.yml
- JWT: jwt.yml
- SSL: ssl.yml
iClient schemas (in references/iclient-schemas/):
- Base fields: request.yml
- Response shape: response.yml
- OAuth2 providers: oauth2.yml
- NetSuite: netsuite.yml
- Salesforce: salesforce.yml
- eBay: ebay.yml
Related Skills
- configuring-exports > Quick Reference -- choosing the right export adaptor type and schema for a data source
More from celigo
Use this skill in a project
Open any RiverX project, search the Skills panel for celigo/ai/configuring-connections, and install it in one click.