# HYROS Installation: Recurly

**Direct URL:** https://app.hyros.com/#/mh/external-services/cart-integration/recurly

---

## STEP 1: Create the Integration Inside HYROS

**If automating:**
Navigate to Settings → Integrations → Recurly Integration in HYROS. Create a new integration, then retrieve the API key and store domain from your Recurly account.

**If guiding user:**
1. "Go into Settings → Integrations → select the Recurly Integration (or use this link: https://app.hyros.com/#/mh/external-services/cart-integration/recurly)"
2. "Click 'Create New Integration'."
3. "Create a name for the integration, such as 'Recurly'."
4. "Get your Private API key from Recurly and the Store domain, then paste it in the field inside your integration."

**How to find these values:**

- **The Store domain:** The store domain is obtained from the store URL when you log in inside your Recurly account. Example: www.**domainname**.recurly.com. "domainname" will be the store domain that needs to be added.

- **Private API key:** Go to Integrations → API credentials, and copy the Private API key.

→ Confirm: "Did you add the API key and store domain?"

---

## STEP 2: Add the Webhook

**If automating:**
Get the webhook from the HYROS Recurly integration, then add it to Recurly under Integrations → Webhooks.

**If guiding user:**
1. "Go to your Recurly integration inside HYROS and click 'configure'."
2. "Click 'Get Webhook' and copy the webhook."
3. "Paste the webhook inside your Recurly account by following these steps:"
   - Go to Integrations
   - Select Webhooks
   - Click on the Configure/create webhook button
   - Click the New endpoint button

4. "In the form, add the following:"
   - **Endpoint name:** you can enter any name, for example, Hyros.
   - **Endpoint URL:** paste the webhook you copied from the HYROS integration.

→ Confirm: "Is the webhook added to Recurly?"

---

## Source
Synced from: docsContent.ts (recurlyGuide)
Last synced: 2026-01-03