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

# Custom Apps

> Connect a custom OAuth or API-key based integration that's not in the standard catalogue.

<Note>
  **Where to find this:** Shopify admin → Apps → Yuko Loyalty → Integrations → Custom Apps
</Note>

## Introduction

If the tool you want to integrate isn't in Yuko's standard connector catalogue, you can build a custom integration using:

* **Custom OAuth Connector** — for tools with OAuth 2.0 endpoints.
* **Custom REST API Connector** — for tools with API-key authentication.
* **Webhooks + REST API** — for fully custom flows.

## When to use

* The tool you want isn't in the catalogue.
* You're building an internal tool that consumes Yuko data.
* You're integrating Yuko with a partner that supports OAuth 2.0 or REST APIs.

## Prerequisites

<Check>You have OAuth credentials or API keys from the target tool.</Check>
<Check>You have a developer who can configure the connector mapping.</Check>

## Setup

<Steps>
  <Step title="Open Custom Apps">
    Go to **Apps → Yuko Loyalty → Integrations → Custom Apps**.
  </Step>

  <Step title="Pick the connector type">
    Choose **OAuth** or **API key** based on what your target tool supports.
  </Step>

  <Step title="Configure endpoints and credentials">
    Enter the OAuth callback URLs / API key + base URL.
  </Step>

  <Step title="Map events to endpoints">
    Pick which Yuko events should hit which endpoint on the target tool.
  </Step>

  <Step title="Save and test">
    Yuko sends a test request to verify the connection.
  </Step>
</Steps>

## Best practices

<Tip>**Use Webhooks + your own integration code** for the most flexible custom flows. Custom Apps is for low-code mappings; webhooks are for full control.</Tip>
<Tip>**Start in a development store.** Custom integrations are easy to misconfigure on production.</Tip>

## FAQs

<AccordionGroup>
  <Accordion title="What's the difference vs Webhooks?">
    Custom Apps lets you push Yuko data to an arbitrary external endpoint without writing receiver code. Webhooks lets you receive Yuko events on your own server. Use either or both.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="REST API" icon="code" href="/integrations/rest-api">
    Read and write Yuko data programmatically.
  </Card>

  <Card title="Webhooks" icon="bolt" href="/integrations/webhooks">
    Receive real-time event notifications.
  </Card>

  <Card title="Shopify Flow" icon="shop" href="/integrations/shopify-flow">
    Trigger Shopify Flow workflows from Yuko events.
  </Card>

  <Card title="Klaviyo" icon="envelope" href="/integrations/klaviyo">
    Sync customers, points and tier data into Klaviyo.
  </Card>

  <Card title="Omnisend" icon="envelope" href="/integrations/omnisend">
    Sync loyalty data into Omnisend.
  </Card>

  <Card title="WhatsApp" icon="comments" href="/integrations/whatsapp">
    Send transactional loyalty messages via 7 supported WhatsApp Business API providers.
  </Card>

  <Card title="Retainful" icon="envelope-open-text" href="/integrations/retainful">
    Email marketing & abandoned cart recovery.
  </Card>

  <Card title="Facebook & Instagram" icon="facebook" href="/integrations/facebook-instagram">
    Social verification for like / follow campaigns.
  </Card>

  <Card title="Google Business" icon="google" href="/integrations/google-business">
    Google Business profile and reviews.
  </Card>

  <Card title="Custom Apps" icon="puzzle-piece" href="/integrations/custom-apps">
    OAuth or API-key based custom integrations.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Book a Free Setup Call" icon="phone" href="https://cal.com/rameshelamathi/yuko-demo">
    Talk to our team for personalised setup help.

    **Time:** 30 minutes
  </Card>

  <Card title="Contact Support" icon="life-ring" href="https://yuko.so/support/">
    Visit our support hub for help articles, live chat and ticket submission.
  </Card>

  <Card title="Browse the Guides" icon="book" href="/getting-started/welcome">
    Documentation across loyalty, referrals, memberships and more.
  </Card>

  <Card title="Install Yuko" icon="shop" href="https://apps.shopify.com/yuko">
    Add Yuko to your Shopify store from the Shopify App Store.
  </Card>
</CardGroup>