Connect external services

Configure a development team, database, or outside API for one app so Koda’s agents can build features that depend on that service—sign-in, shared data, Shopify catalogs, and similar integrations. Credentials are kept in Koda and called through a secure proxy so secrets never land in chat or in the app binary, where they could be extracted from a shipped iOS build.

Open an App's Settings Page

1
Open Apps and open the app’s settings page.

Link Supabase

1
Connect Supabase from the main Integrations page first (see Connect Supabase).
2
Return to the app’s settings and choose a Supabase project, or create one.
3
Link it to the current app. Koda can then configure database-backed features for this project.

Connect an External API/Service to an App

In the app’s settings under Service configuration, you can add a service in either of two ways: start from a provider preset, or build a custom service from a blank configuration. Presets fill in the fields, proxy, and verification for you; custom services give you full control when no preset exists.

1
Open the app’s settings page from Apps, then scroll to Service configuration.
2
To use a preset, choose a provider under Explore presets (for example Shopify). To configure any other API yourself, select Custom service.
Use Custom service for a blank setup, or pick a provider under Explore presets such as Shopify.
3
For a custom service, enter a plain name and description, add the fields the service needs, and mark passwords, tokens, and private values as Secret.
A custom service lets you name the API, choose API key or OAuth 2.0, and define the fields and proxy the agent will use.
4
Choose API key or OAuth 2.0, set the upstream base URL, and map credential fields, headers, or OAuth details as needed.
5
Configure a safe verification request, then select Save configuration or Save & verify proxy before asking the agent to use the service.

Good to knowSecrets are stored separately and proxied at runtime. Never paste a secret into chat or commit it to your app’s source code.

Connect Shopify to an App

The Shopify preset can add Storefront, Admin, or both. After Koda creates the service, you add the app’s client ID and client secret, then save and verify so the agent can call Shopify through the secure proxy.

1
In Service configuration, select Shopify under Explore presets.
The Shopify preset asks for your store domain, then lets you add Storefront, Admin, or both.
2
Enter your Shopify store domain (for example example-store.myshopify.com).
3
Choose Add Storefront service for customer-facing catalog, product, collection, cart, and checkout flows through Shopify Storefront GraphQL. Choose Add Admin service for merchant operations such as products, orders, inventory, and other store management through Shopify Admin GraphQL. Add both if the app needs both surfaces.
4
Open each new Shopify service and enter the Shopify app’s client ID and client secret. Keep the secret marked as Secret so it stays in the vault.
After the preset is added, fill in client ID and client secret on the Shopify service, then save and verify so the agent can use it.
5
Select Save configuration, then use Test token endpoint or proxy verification to confirm the connection before asking the agent to use Shopify.

Good to knowStorefront enables shopping experiences in the app. Admin enables backend store management the agent can perform on your behalf. Use only the APIs your Shopify app is allowed to access.