I’m trying to connect a third-party API to my Lyzr agent using OAuth authentication through ACI.dev. I understand Lyzr is moving towards open-sourcing tools via ACI.dev, but I’m struggling to understand the full setup flow. Do I configure the OAuth app on ACI.dev first and then import it into Lyzr, or is there configuration needed on both ends? Would love a step-by-step breakdown from someone who’s actually done this!
Connecting a Third-Party API to Lyzr Agent via ACI.dev (OAuth & More)
Great question! Here’s the full picture broken down simply.
How it works — the big picture
ACI.dev acts as the middleware that handles all the heavy lifting: authentication, token refresh, key storage, and encryption. You define your tool in Lyzr Agent Studio, and ACI.dev handles everything from there.
Step 1 — Add your Custom Tool in Lyzr Agent Studio
- Go to https://studio.lyzr.ai/configure/tools
- Click the “Add Custom Tool” button
- Select “Custom ACI Tool”
- Paste in your
app.jsonandfunction.jsonfiles- Not sure what these look like? Example files are available right on that page for reference
These two files tell ACI.dev everything it needs to know:
app.json— describes the app (name, logo, auth type, etc.)function.json— describes what the app can actually do (the API endpoints/actions)
ACI.dev supports three auth types:
| Auth Type | How it works |
|---|---|
| No Auth | Connects instantly, no credentials needed |
| API Key | You paste in your API key once |
| OAuth 2.0 | ACI redirects you through the provider’s login flow |
Step 2 — Create a Credential
Once your tool is defined, create a new credential for it:
- OAuth → you’ll be redirected to the provider (e.g. Google) to authorize
- API Key → paste your key in
- No Auth → connects automatically
ACI.dev then securely stores and manages that credential for you going forward — including token refresh and encryption.
Step 3 — Add the Tool to your Lyzr Agent
Once connected, head to your agent in Lyzr Agent Studio and add the tool. Your agent will now be able to call that API automatically.
To directly answer your question: Everything is configured through Lyzr Agent Studio — it handles the ACI.dev integration under the hood. No need to set anything up separately on ACI.dev’s side.