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

# Connecting Syrve

> Connect Syrve POS to storekit: add your Syrve API Login, pick an organization, enable the integration, and register webhooks for live updates.

Connecting Syrve links your storekit account to your Syrve organization. You enter your Syrve **API Login** once, then configure each store: pick the **Organization**, enable the integration, and map how orders should land on the POS.

## Prerequisites

* A Syrve Cloud account with API access
* Your Syrve **API Login** — the API credential for your organization, issued by Syrve or your Syrve reseller
* The Syrve integration enabled on your storekit account

<Note>
  If **Syrve** does not appear in your **Integrations** list, the integration isn't enabled for your account yet — [contact storekit support](/docs/getting-started/contact-support).
</Note>

## Connect Your Organization

<Steps>
  <Step title="Open the Syrve integration">
    Go to **Stores** → your store → **Settings** → **Integrations**, then select **Syrve**.
  </Step>

  <Step title="Enter your API Login">
    On the **Syrve Settings** page, under **Syrve API Settings**, enter your credential in **API Login** and click **Save**. storekit validates it against Syrve before storing it — if Syrve can't be reached with it, you'll see an error and nothing is saved.
  </Step>

  <Step title="Enable the integration">
    Turn on **Enable Syrve**.
  </Step>

  <Step title="Pick your organization">
    Select the Syrve **Organization** this store belongs to. storekit then loads that organization's terminal groups, order types, payment types, discounts, tips types, cancel causes, and external menus so you can map them.
  </Step>

  <Step title="Save">
    Click **Save**. An organization must be selected before the settings can be saved.
  </Step>
</Steps>

Once connected, the **Syrve API Settings** section collapses to a **Connected** state with your credential masked (only the last characters shown). Click **Edit** to view the section again, and use the pencil icon to replace the API Login.

<Note>
  The **API Login** is stored once for your whole storekit account — every store on the account connects to Syrve with it. The **Organization** and everything below it are per store.
</Note>

## Set Up Webhooks

Webhooks let Syrve push order updates to storekit, so orders progress automatically as the kitchen works through them (and stock changes arrive as they happen).

<Steps>
  <Step title="Save your settings first">
    Webhooks are registered for the saved **Organization** — save your settings before setting them up.
  </Step>

  <Step title="Setup webhooks">
    Under **Syrve Webhooks**, click **Setup webhooks**. storekit registers itself with Syrve and then re-reads the settings from Syrve to confirm — the green **Webhooks enabled** panel shows the destination and the enabled events.
  </Step>
</Steps>

<Warning>
  Without webhooks, storekit still confirms each order made it onto the till (it checks for about 5 minutes after sending), but later kitchen statuses and live stock changes won't arrive — the yellow **Webhooks not configured** panel warns that orders will have to be progressed manually in storekit.
</Warning>

To stop Syrve pushing updates, click **Disable webhooks** (the same button, once webhooks are configured).

<Info>
  If you change the **Organization**, the webhook panel shows **Organization changed** — save your settings to see the webhook status for the new organization, and set webhooks up again if needed.
</Info>

## What Connecting Changes

* Enabling Syrve sets this store's POS provider to Syrve. Orders are only dispatched once the **Organization** and a **Terminal Group** are set.
* After an organization is selected, the rest of the **Syrve Settings** page becomes available: **Syrve Menu**, **Syrve Order Complications**, and **Syrve Webhooks**.

## Next Steps

<CardGroup cols={2}>
  <Card title="Sync your menu" icon="utensils" href="/docs/guides/integrations/pos/syrve/menu-sync">
    Import your Syrve external menu into storekit
  </Card>

  <Card title="Set up orders" icon="receipt" href="/docs/guides/integrations/pos/syrve/orders">
    Map order types, payments, and charges
  </Card>
</CardGroup>

## Related

* [Syrve POS Overview](/docs/guides/integrations/pos/syrve/overview)
* [Troubleshooting](/docs/guides/integrations/pos/syrve/troubleshooting)


## Related topics

- [Syrve Troubleshooting](/docs/guides/integrations/pos/syrve/troubleshooting.md)
- [Syrve POS](/docs/guides/integrations/pos/syrve/overview.md)
- [Syrve Menu Sync](/docs/guides/integrations/pos/syrve/menu-sync.md)
- [Syrve Orders & Payments](/docs/guides/integrations/pos/syrve/orders.md)
- [Connecting Toast](/docs/guides/integrations/pos/toast/connect.md)
