Skip to main content
Every app you build in Synthetiq automatically gets its own API. By making that API public and turning it into a service, any of your other apps can read its data and trigger its actions — without reconnecting the original data sources.
Apps in the same workspace already connect automatically — when you build a new app, the AppWriter agent can draw on your other apps with no setup. Follow this tutorial to connect to a deployed app, such as one a colleague deployed or one you want any app to reach.

Prerequisites

  • An app that’s already deployed — connecting uses the deployed app’s live API. If you haven’t deployed yet, see Publish an App.
  • Admin access to that app, so you can open its OAuth Clients and API & MCP Access pages.
  • A second app — new or existing — where you want to use the first app’s data.
1

Open your app's OAuth Clients page

Open your deployed app and go to its Admin area. In the admin menu, click OAuth Clients. At the top of the page you’ll see a card titled API manifest (/api.json).The deployed app's OAuth Clients admin page with the API manifest (/api.json) card at the top, above the list of OAuth clientsThe deployed app's OAuth Clients admin page with the API manifest (/api.json) card at the top, above the list of OAuth clients
2

Make the API manifest public

In the API manifest (/api.json) card, open the dropdown on the right and choose Public — anyone. This lets other apps and agents read your app’s API without signing in.The API manifest visibility dropdown set to Public — anyoneThe API manifest visibility dropdown set to Public — anyone
3

Copy your app's API address

In your deployed app, open the user menu and click API & MCP Access. The page lists the app’s connection endpoints, each with a copy button:
  • API base URL — for API clients, ends in /api
  • MCP server endpoint — for MCP clients such as Claude Desktop, ends in /mcp
Always copy the API base URL from its card rather than typing it. Synthetiq generates each app’s API host from where the app is deployed — it can sit on a numbered shard or a custom (vanity) domain — so the address differs from app to app and isn’t something you can guess. The API manifest is that same address with .json on the end: copy the API base URL, add .json, then open it in a browser to confirm you see the manifest — a page listing the app’s endpoints.
To connect an MCP client to the app directly instead of creating a service, use the MCP server endpoint from the same page, with a client ID and secret from an OAuth application created there.
The app's API manifest at /api.json, showing the auth block and the list of API endpoints
4

Ask Synthetiq to create a service

Switch to Synthetiq and open the chat. Paste the address you copied and ask the agent to create a service for it — for example, “Create a service for the API at the URL I just copied.” The Workspace agent hands off to the ServiceWriter agent, which reads the manifest, builds the service, and adds it to your workspace. For the full service-building walkthrough, see Create Your First Service with the Service Writer.The chat showing the Workspace agent handing off to the ServiceWriter agentThe chat showing the Workspace agent handing off to the ServiceWriter agent
5

Check the new service

When ServiceWriter finishes, open the Services panel from the left menu. Your new service appears in the list. Click it to see the tools it provides — one for each action the app exposes.The Services panel showing the new service and its available toolsThe Services panel showing the new service and its available tools
6

Use the service in your other app

Now build or update your second app to use the service. In the chat, ask the agent to build or change an app that uses it — for example, “Build a Sales Forecasting app that reads deal data from the Customer 360 service.” The Workspace agent hands off to the AppWriter agent, which connects the service so your new app reads live data straight from the first app. For a full app build, see Create Your First App with the App Writer.The chat showing the Workspace agent handing off to the AppWriter agent to build an app that uses the serviceThe chat showing the Workspace agent handing off to the AppWriter agent to build an app that uses the service

What’s next

How Apps and Services Work Together

See how every app you build becomes a reusable service for the next one.

Create Your First App with the App Writer

Build an app from a chat message — and point it at the service you just created.