Apps Integration

What this page does

Apps Integration (/settings/apps-integration) is where you connect ClinyPal to third-party apps and services — calendar syncs, payment providers, file storage, email/CRM tools, and more. It's the single most varied page in ClinyPal's settings: different apps show different buttons, and connecting one can mean anything from a single click to filling out a credential form.

What you'll learn

What the health hero and its stat chips show
Why different integration cards show different action buttons
The four distinct "drawer shapes" you'll see once you open an integration
How Apple Calendar, Stripe, and PayPal/Brevo/HubSpot are special cases
When footer buttons like Reconnect and Save appear
How connecting a payment provider here unlocks Online Booking deposits

The Apps Integration page, showing the health hero with stat chips at the top and a grid of integration cards below, each with a status and an action button.

The health hero

At the top of the page, a health hero summarizes the state of your integrations using stat chips.

Stat chips only appear when their count is greater than zero The "Needs attention" chip (integrations with an error status) and the "Coming soon" chip (integrations not yet available) only render when there's actually at least one to count. If nothing needs attention, that chip simply isn't shown, rather than showing a zero.

Integration card action buttons

Each integration is shown as a card, and the button on that card depends on the integration's current status and type.

Card status / type	Button shown	What it does
Connected	Manage	Opens the management drawer for that integration.
Error	Reconnect	Opens the management drawer, typically to walk through reconnecting.
Not connected — Apple Calendar, PayPal, Brevo, HubSpot	Enable / Connect	Opens the management drawer directly, since setup happens inside the drawer for these apps.
Not connected — Google Drive, OneDrive	Connect	Opens a consent modal first, before the drawer.
Not connected — most other apps	Connect	Goes straight into an OAuth connect flow with the provider.
Not yet available	Notify me (disabled)	Nothing — it's disabled until the integration ships.

Google Drive and OneDrive show a consent modal first Unlike most not-connected apps that go straight to an OAuth flow, clicking Connect on Google Drive or OneDrive opens a consent modal first. Only after you proceed through that modal does the connect flow continue.

The four drawer shapes

Once you open an integration's management drawer, its layout falls into one of four shapes depending on the type of app.

App type	What you see before connecting	What you see once connected
Sync-shape (calendar and CRM syncs)	Connect flow, then the drawer with a target-selector dropdown for choosing what to sync.	The drawer shows connection status, the target-selector dropdown, and a Sync button.
Connect-only (Square, Google Drive, OneDrive)	Connect flow (Google Drive and OneDrive show a consent modal first).	The drawer shows connection status only, with disconnect/reconnect actions — there's no target picker for these.
Apple Calendar (special case)	An Enable explainer with an Enable button, opened directly from the card.	The drawer shows the feed URL, a Copy button, an "Add to Apple Calendar" link (visible only on Apple devices), and a Regenerate link button.
Stripe (special case)	Connect flow.	Connection status, plus a note pointing you to the deposit-percentage setting under Online Booking.
PayPal / Brevo / HubSpot (special case)	A credential-entry form — Client ID/Secret for PayPal, or an API key/token for Brevo and HubSpot — with a show/hide toggle for the secret field. PayPal's form also includes a "Use sandbox" checkbox.	Connection status, a target/list picker (Brevo and HubSpot only), a Sync button, and a credential form for rotating keys.

Re-entry credential fields are always blank For PayPal, Brevo, and HubSpot, the credential form shown after connecting — used for rotating keys — is always blank. Stored secrets are never displayed again once saved, for security. Leaving the fields blank and saving does not clear your existing credentials; you only need to fill them in if you're actually rotating the key.

The management drawer for a sync-shape integration (connected state), showing connection status, a target-selector dropdown, and a Sync button.

The Apple Calendar drawer in its connected state, showing the feed URL, a Copy button, the Apple-devices-only 'Add to Apple Calendar' link, and a Regenerate link button.

The PayPal drawer before connecting, showing the Client ID and Client Secret fields with a show/hide toggle on the secret field, and the 'Use sandbox' checkbox below.

"Reconnect" / "Finish setup" — only shown when the integration's status is Error.
"Save" (for the target picker) — only shown when a selectable target actually exists to save.

Footer buttons are conditional, not always present Don't expect every drawer to show the same footer. Reconnect-style buttons only appear on integrations currently in an Error state, and the Save button for a target picker only appears once there's something to select and save.

Payment integrations unlock Online Booking deposits

Connect a payment provider here to enable deposits Connecting Stripe, PayPal, or Square in Apps Integration is what unlocks the deposit-percentage setting on the Online Booking Payments tab. Without one of these connected, that tab only shows a message asking you to connect a provider first.

Configure Online Booking

See how the deposit percentage setting works once a payment provider is connected here.