Managing Connections

Securely store credentials and reuse them across scenarios and agents.

Connections hold the credentials, endpoints, and settings your agents need to talk to external systems. Centralizing them keeps scenarios cleaner and lets you rotate secrets without editing every flow.

Common connection types

  • Commerce platforms (Shopify, marketplaces, ERPs).
  • File transports (SFTP/FTPS), storage buckets, or CDNs.
  • AI providers and general HTTP APIs.
  • Internal services exposed through API gateways.

How to set them up

  1. Create a new connection with the minimal scope needed (read-only vs read/write).
  2. Store keys, tokens, or passwords using the secure fields provided—avoid embedding secrets in steps.
  3. Associate the connection with agents that require it, then reference it from steps via its name.
  4. Test the connection before wiring it into production scenarios.

Operational practices

  • Rotate credentials on a schedule and keep multiple keys briefly overlapped to avoid downtime.
  • Use separate connections for sandbox vs production to prevent accidental data changes.
  • Audit which scenarios reference each connection before deleting or rotating it.