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

# Use with AI

> Integrate your product into your app in one click with your favorite AI builder.

## One-click integration

Launch your favorite AI builder with the full Suby integration prompt already written. It scaffolds your database, API calls, webhook handler, and UI, so all you have to do is paste your API keys.

<CardGroup cols={3}>
  <Card title="Open in Lovable" icon="heart" href="https://lovable.dev/?prompt=Add%20a%20full%20custom%20%5BPRODUCT_NAME%5D%20%28https%3A//%5BPRODUCT_URL%5D%29%20integration%20into%20this%20project.%20Do%20NOT%20use%20built-in%20Lovable%20integrations%20%E2%80%94%20use%20Supabase%20Edge%20Functions%20%2B%20webhooks%20for%20full%20control.%20Docs%3A%20https%3A//documentation.suby.fi/llms-full.txt%0A%0AStore%20as%20Lovable%20Cloud%20secrets%3A%20%5BPRODUCT%5D_API_KEY%20and%20%5BPRODUCT%5D_WEBHOOK_SECRET.%0A%0ABuild%3A%0A1.%20Supabase%20tables%3A%20a%20main%20resource%20table%20tracking%20%5BPRODUCT_NAME%5D%20state%20locally%20%28id%2C%20user_id%2C%20external_id%2C%20status%2C%20metadata%2C%20created_at%29%20and%20an%20event_logs%20table%20%28id%2C%20user_id%2C%20event_id%2C%20event_type%2C%20payload%2C%20created_at%29.%20Add%20%5BPRODUCT%5D_customer_id%20to%20profiles.%20Include%20RLS.%0A2.%20Edge%20Function%20create-%5BPRODUCT%5D-action%20%28POST%29%3A%20accepts%20the%20minimum%20payload%20for%20the%20action%2C%20calls%20%5BPRODUCT_NAME%5D%20API%2C%20returns%20the%20response%2C%20logs%20the%20attempt.%0A3.%20Edge%20Function%20%5BPRODUCT%5D-webhook%20%28POST%2C%20public%29%3A%20verifies%20HMAC%20with%20%5BPRODUCT%5D_WEBHOOK_SECRET%2C%20handles%20all%20relevant%20events%2C%20updates%20DB%2C%20returns%20200%20fast.%0A4.%20UI%3A%20reusable%20action%20button%20component%2C%20success%20page%20with%20realtime%20DB%20subscription%20for%20instant%20confirmation%2C%20dashboard%20card%20with%20current%20status%20%2B%20management%20actions.%0A5.%20TypeScript%2C%20sandbox%20mode%20detection%2C%20user-friendly%20errors%2C%20no%20client-side%20secrets%2C%20clean%20comments.%0A%0ATell%20me%20at%20the%20end%3A%20secret%20names%20to%20fill%20in%2C%20webhook%20URL%20for%20%5BPRODUCT_NAME%5D%20Dashboard%20%E2%86%92%20Settings%20%E2%86%92%20Webhooks%2C%20how%20to%20test%20end-to-end%20in%20sandbox.%20Go%20step%20by%20step%20and%20confirm%20each%20part%20before%20the%20next.">
    Spin up a full Supabase + webhooks integration in one click.
  </Card>

  <Card title="Open in Claude" icon="message-bot" href="https://claude.ai/new?q=Integrate%20%5BPRODUCT_NAME%5D%20%28https%3A//%5BPRODUCT_URL%5D%29%20into%20this%20project.%20Use%20the%20full%20docs%20at%20https%3A//documentation.suby.fi/llms-full.txt%20as%20source%20of%20truth.%0A%0ABuild%3A%0A1.%20Database%3A%20a%20main%20resource%20table%20tracking%20%5BPRODUCT_NAME%5D%20state%20locally%20%28id%2C%20user_id%2C%20external_id%2C%20status%2C%20metadata%2C%20created_at%29%20and%20an%20event_logs%20table.%20Add%20%5BPRODUCT%5D_customer_id%20to%20profiles.%0A2.%20Server%20route%20create-%5BPRODUCT%5D-action%20%28POST%29%3A%20accepts%20the%20minimum%20payload%2C%20calls%20%5BPRODUCT_NAME%5D%20API%20with%20%5BPRODUCT%5D_API_KEY%2C%20returns%20the%20response.%0A3.%20Server%20route%20%5BPRODUCT%5D-webhook%20%28POST%2C%20public%29%3A%20verifies%20signature%20with%20%5BPRODUCT%5D_WEBHOOK_SECRET%2C%20handles%20all%20relevant%20events%2C%20updates%20DB%20%2B%20grants/revokes%20access.%0A4.%20Frontend%3A%20reusable%20action%20button%20component%2C%20success%20page%20with%20realtime%20status%2C%20dashboard%20card%20showing%20current%20state%20with%20management%20actions.%0A5.%20TypeScript%20strict%2C%20sandbox%20mode%20support%2C%20full%20error%20handling%2C%20never%20expose%20API%20keys%20client-side%2C%20production-ready.%0A%0AAt%20the%20end%2C%20tell%20me%3A%20the%20exact%20secret%20names%20%28%5BPRODUCT%5D_API_KEY%2C%20%5BPRODUCT%5D_WEBHOOK_SECRET%29%2C%20the%20webhook%20URL%20to%20paste%20into%20%5BPRODUCT_NAME%5D%20Dashboard%20%E2%86%92%20Settings%20%E2%86%92%20Webhooks%2C%20and%20end-to-end%20test%20steps.%20Go%20step%20by%20step.">
    Open Claude with the full integration prompt pre-loaded.
  </Card>

  <Card title="Open in ChatGPT" icon="robot" href="https://chatgpt.com/?q=Integrate%20%5BPRODUCT_NAME%5D%20%28https%3A//%5BPRODUCT_URL%5D%29%20into%20this%20project.%20Use%20the%20full%20docs%20at%20https%3A//documentation.suby.fi/llms-full.txt%20as%20source%20of%20truth.%0A%0ABuild%3A%0A1.%20Database%3A%20a%20main%20resource%20table%20tracking%20%5BPRODUCT_NAME%5D%20state%20locally%20%28id%2C%20user_id%2C%20external_id%2C%20status%2C%20metadata%2C%20created_at%29%20and%20an%20event_logs%20table.%20Add%20%5BPRODUCT%5D_customer_id%20to%20profiles.%0A2.%20Server%20route%20create-%5BPRODUCT%5D-action%20%28POST%29%3A%20accepts%20the%20minimum%20payload%2C%20calls%20%5BPRODUCT_NAME%5D%20API%20with%20%5BPRODUCT%5D_API_KEY%2C%20returns%20the%20response.%0A3.%20Server%20route%20%5BPRODUCT%5D-webhook%20%28POST%2C%20public%29%3A%20verifies%20signature%20with%20%5BPRODUCT%5D_WEBHOOK_SECRET%2C%20handles%20all%20relevant%20events%2C%20updates%20DB%20%2B%20grants/revokes%20access.%0A4.%20Frontend%3A%20reusable%20action%20button%20component%2C%20success%20page%20with%20realtime%20status%2C%20dashboard%20card%20showing%20current%20state%20with%20management%20actions.%0A5.%20TypeScript%20strict%2C%20sandbox%20mode%20support%2C%20full%20error%20handling%2C%20never%20expose%20API%20keys%20client-side%2C%20production-ready.%0A%0AAt%20the%20end%2C%20tell%20me%3A%20the%20exact%20secret%20names%20%28%5BPRODUCT%5D_API_KEY%2C%20%5BPRODUCT%5D_WEBHOOK_SECRET%29%2C%20the%20webhook%20URL%20to%20paste%20into%20%5BPRODUCT_NAME%5D%20Dashboard%20%E2%86%92%20Settings%20%E2%86%92%20Webhooks%2C%20and%20end-to-end%20test%20steps.%20Go%20step%20by%20step.">
    Open ChatGPT with the full integration prompt pre-loaded.
  </Card>
</CardGroup>

<Tip>
  After your AI finishes, add `[PRODUCT]_API_KEY` and `[PRODUCT]_WEBHOOK_SECRET` as secrets, then paste the webhook URL it gives you into **Suby Dashboard → Settings → Webhooks**.
</Tip>

***

## Just load the docs

Want to ask questions instead of building? Open a chat with the full Suby documentation loaded as context.

<CardGroup cols={2}>
  <Card title="Ask Claude" icon="message-bot" href="https://claude.ai/new?q=https://documentation.suby.fi/llms-full.txt">
    Load the full Suby docs into a Claude conversation.
  </Card>

  <Card title="Ask ChatGPT" icon="robot" href="https://chatgpt.com/?q=https://documentation.suby.fi/llms-full.txt">
    Load the full Suby docs into a ChatGPT conversation.
  </Card>
</CardGroup>

***

## Plain text

If your tool accepts a URL or raw text, paste one of these directly into the context window.

| Format    | URL                                           | Best for                       |
| --------- | --------------------------------------------- | ------------------------------ |
| Summary   | `https://documentation.suby.fi/llms.txt`      | Quick context, token-efficient |
| Full docs | `https://documentation.suby.fi/llms-full.txt` | Deep integration work          |

***

## After the AI finishes

<Steps>
  <Step title="Add your API credentials">
    Grab them from your [Suby dashboard](https://\[DASHBOARD_URL]) and save them as:

    * `[PRODUCT]_API_KEY`
    * `[PRODUCT]_WEBHOOK_SECRET`
  </Step>

  <Step title="Register the webhook">
    Copy the webhook URL your AI generated and paste it into **Suby Dashboard → Settings → Webhooks**.
  </Step>

  <Step title="Test in sandbox">
    Use Suby's test credentials to run a full end-to-end flow, verify the webhook fires, and confirm everything updates correctly in your database.
  </Step>

  <Step title="Go live">
    Swap test credentials for production credentials and you're ready to ship.
  </Step>
</Steps>

***

## What the AI will know

Once loaded, your assistant has full context on:

<CardGroup cols={2}>
  <Card title="API endpoints" icon="code">
    Authentication, core resources, and all available operations.
  </Card>

  <Card title="Webhooks" icon="webhook">
    All events, payload structure, and signature verification.
  </Card>

  <Card title="Core features" icon="sparkles">
    The main capabilities of Suby and how to use them.
  </Card>

  <Card title="Integration guides" icon="plug">
    SDKs, frameworks, and platform-specific adapters.
  </Card>

  <Card title="Data model" icon="database">
    Resources, relationships, and recommended schema.
  </Card>

  <Card title="Limits & pricing" icon="receipt">
    Rate limits, quotas, and billing details.
  </Card>
</CardGroup>

<Tip>
  For complex integrations, use `llms-full.txt` for maximum context. For quick Q\&A, the summary `llms.txt` is faster.
</Tip>