> ## Documentation Index
> Fetch the complete documentation index at: https://synthetiq.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Connect One App to Another

> Expose a deployed app's API and turn it into a service so your other apps can use its data and actions.

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.

<Note>
  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.
</Note>

## Prerequisites

* An app that's already **deployed** — connecting uses the deployed app's live API. If you haven't deployed yet, see [How to Publish an App](/docs/tutorials/publishing-an-app).
* Admin access to that app, so you can open its **OAuth Clients** page.
* A second app — new or existing — where you want to use the first app's data.

<Steps>
  <Step title="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)**.

    <img src="https://mintcdn.com/synthetiq/49DWOOCswOz-GQW6/images/tutorials/connecting-apps/step-01-oauth-clients-light.png?fit=max&auto=format&n=49DWOOCswOz-GQW6&q=85&s=d49aba3a649696f5d8bac39c1ac49bd4" className="block dark:hidden" alt="The deployed app's OAuth Clients admin page with the API manifest (/api.json) card at the top, above the list of OAuth clients" width="1280" height="800" data-path="images/tutorials/connecting-apps/step-01-oauth-clients-light.png" />

    <img src="https://mintcdn.com/synthetiq/49DWOOCswOz-GQW6/images/tutorials/connecting-apps/step-01-oauth-clients-dark.png?fit=max&auto=format&n=49DWOOCswOz-GQW6&q=85&s=f724528e9ac1d12fd097de7b5ed6db11" className="hidden dark:block" alt="The deployed app's OAuth Clients admin page with the API manifest (/api.json) card at the top, above the list of OAuth clients" width="1280" height="800" data-path="images/tutorials/connecting-apps/step-01-oauth-clients-dark.png" />
  </Step>

  <Step title="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.

    <img src="https://mintcdn.com/synthetiq/49DWOOCswOz-GQW6/images/tutorials/connecting-apps/step-02-manifest-public-light.png?fit=max&auto=format&n=49DWOOCswOz-GQW6&q=85&s=b51f41d41cb26485d8488c64b528076b" className="block dark:hidden" alt="The API manifest visibility dropdown set to Public — anyone" width="1280" height="800" data-path="images/tutorials/connecting-apps/step-02-manifest-public-light.png" />

    <img src="https://mintcdn.com/synthetiq/49DWOOCswOz-GQW6/images/tutorials/connecting-apps/step-02-manifest-public-dark.png?fit=max&auto=format&n=49DWOOCswOz-GQW6&q=85&s=371c1ad747d67b2b861c310b620b70b9" className="hidden dark:block" alt="The API manifest visibility dropdown set to Public — anyone" width="1280" height="800" data-path="images/tutorials/connecting-apps/step-02-manifest-public-dark.png" />
  </Step>

  <Step title="Copy your app's API address">
    Your app's API has its own address — your app's domain with `api.` in front. For example, if your app is at `myapp.synthetiqapps.com`, its API lives at `myapp.api.synthetiqapps.com`, and the manifest is at `myapp.api.synthetiqapps.com/api.json`. Open that `/api.json` address in a browser to confirm you see the API manifest — a page listing the app's endpoints — then copy it.

    <img src="https://mintcdn.com/synthetiq/49DWOOCswOz-GQW6/images/tutorials/connecting-apps/step-03-api-json.png?fit=max&auto=format&n=49DWOOCswOz-GQW6&q=85&s=c377697fe33487d60a0b12a293280b84" alt="The app's API manifest at /api.json, showing the auth block and the list of API endpoints" width="1280" height="800" data-path="images/tutorials/connecting-apps/step-03-api-json.png" />
  </Step>

  <Step title="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](/docs/quickstart/service-writer).

    <img src="https://mintcdn.com/synthetiq/RNJQjOGIp-QHg-Gg/images/tutorials/service-writer/step-03-mode-switch-light.png?fit=max&auto=format&n=RNJQjOGIp-QHg-Gg&q=85&s=6f343984127fd9868898cdf650a9e2be" className="block dark:hidden" alt="The chat showing the Workspace agent handing off to the ServiceWriter agent" width="1360" height="880" data-path="images/tutorials/service-writer/step-03-mode-switch-light.png" />

    <img src="https://mintcdn.com/synthetiq/RNJQjOGIp-QHg-Gg/images/tutorials/service-writer/step-03-mode-switch-dark.png?fit=max&auto=format&n=RNJQjOGIp-QHg-Gg&q=85&s=bce488756acf90c4b719f1715bdbed8f" className="hidden dark:block" alt="The chat showing the Workspace agent handing off to the ServiceWriter agent" width="1360" height="880" data-path="images/tutorials/service-writer/step-03-mode-switch-dark.png" />
  </Step>

  <Step title="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.

    <img src="https://mintcdn.com/synthetiq/RNJQjOGIp-QHg-Gg/images/tutorials/service-writer/step-08-service-tools-light.png?fit=max&auto=format&n=RNJQjOGIp-QHg-Gg&q=85&s=d8c4b3f36cce45322d5253ba5d0fbc75" className="block dark:hidden" alt="The Services panel showing the new service and its available tools" width="1360" height="880" data-path="images/tutorials/service-writer/step-08-service-tools-light.png" />

    <img src="https://mintcdn.com/synthetiq/RNJQjOGIp-QHg-Gg/images/tutorials/service-writer/step-08-service-tools-dark.png?fit=max&auto=format&n=RNJQjOGIp-QHg-Gg&q=85&s=46bf067391b30bed24daed7660999a19" className="hidden dark:block" alt="The Services panel showing the new service and its available tools" width="1360" height="880" data-path="images/tutorials/service-writer/step-08-service-tools-dark.png" />
  </Step>

  <Step title="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](/docs/quickstart/app-writer).

    <img src="https://mintcdn.com/synthetiq/RNJQjOGIp-QHg-Gg/images/tutorials/app-writer/step-03-mode-switch-light.png?fit=max&auto=format&n=RNJQjOGIp-QHg-Gg&q=85&s=4c78cc3089a9f75812b34f4ee97f4019" className="block dark:hidden" alt="The chat showing the Workspace agent handing off to the AppWriter agent to build an app that uses the service" width="1360" height="880" data-path="images/tutorials/app-writer/step-03-mode-switch-light.png" />

    <img src="https://mintcdn.com/synthetiq/RNJQjOGIp-QHg-Gg/images/tutorials/app-writer/step-03-mode-switch-dark.png?fit=max&auto=format&n=RNJQjOGIp-QHg-Gg&q=85&s=343aa509718685b7eb2d9d363dfd4233" className="hidden dark:block" alt="The chat showing the Workspace agent handing off to the AppWriter agent to build an app that uses the service" width="1360" height="880" data-path="images/tutorials/app-writer/step-03-mode-switch-dark.png" />
  </Step>
</Steps>

## What's next

<CardGroup cols={2}>
  <Card title="How Apps and Services Work Together" icon="diagram-project" href="/docs/quickstart/apps-and-services">
    See how every app you build becomes a reusable service for the next one.
  </Card>

  <Card title="Create Your First App with the App Writer" icon="wand-magic-sparkles" href="/docs/quickstart/app-writer">
    Build an app from a chat message — and point it at the service you just created.
  </Card>
</CardGroup>
