Skip to main content
This guide is the long-form companion to the Foundry documentation. The main docs cover what Foundry does and how the UI is laid out. This guide is here to help you learn: see worked examples, follow walkthroughs against real third-party tools, and pick up tips from teams already using it. If you’re new to Foundry, start with the main docs and come back here when you want to go deeper.

Foundry overview

What Foundry is, key terms, and where to find things in the UI.

Building functions

Reference for creating, testing, and publishing functions.

Integrations

Reference for managing integrations and OAuth providers.

Using functions

Reference for using published functions in workflows and agents.

​
What’s in this guide

Set up a custom API integration

Walkthrough for connecting a tool that uses a static credential like an API key.

Set up a custom OAuth app

What an OAuth app is, what Foundry needs from one, and walkthroughs for Google Cloud, GitHub, and DocuSign.

Examples

Real things teams build with Foundry, with the prompts they used to generate them.

Tips & troubleshooting

Practices that lead to better functions, plus fixes for the most common issues.

​
How to use this guide

  • Each walkthrough is self-contained. You can jump straight to the OAuth or API setup you need.
  • The examples are starting points. Each one shows the prompt to give Foundry and points at the integration shape required, so you can adapt them to your tools.
  • Technical reference stays in the main docs. When you need the exact list of ctx.ravenna operations, the ActionContext shape, or the validation behaviour, this guide will send you there. That way the reference stays correct as Foundry evolves and these guides stay focused on learning.
Ready to start? Begin with Set up a custom API integration, or read the OAuth setup overview before picking a walkthrough.
Last modified on June 4, 2026