---
title: Stay AI
slug: stay-ai
docTags: 
createdAt: 2026-05-14T13:34:59.644Z
---

Connect your Stay AI subscription data to Chord. Stay AI (formerly Retextion) is the subscription management platform powering recurring billing, customer portals, and lifecycle automations for Shopify subscription brands. Chord ingests subscription, order, and selling plan data from Stay AI so you can model retention, churn, and lifetime value alongside the rest of your stack.

## What Chord ingests from Stay AI

Chord pulls 3 datasets from your Stay AI account.

- **Subscriptions:** active and historical subscription records: status, line items, cadence, next billing date, customer link.
- **Orders:** subscription-driven orders linked back to the originating subscription contract.
- **Selling plan groups:** selling plan group definitions: cadences, bundle configuration, product mappings.

## Generate a Stay AI API key

You'll need a Stay AI API key from the merchant portal. There are no scopes or permissions to configure, it's a single token that grants read access to the Stay AI REST API.

:::hint{type="warning"}
**Heads up:** only users with admin access to the Stay AI merchant portal can generate API keys. If your role doesn't include it, ask an admin on the account to either generate the key for you or grant your user the permission first.
:::

1. Log in to the Stay AI merchant portal.
2. In the left sidebar, go to **Settings → API Keys**.
3. Click **New API Key**. Name the key something recognizable, e.g. `chord data sync`.
4. In the API Keys table, find the new row and click **Show** in the Private Key column to reveal the key.
5. Copy the key value.

:::hint{type="info"}
**Heads up:** unlike most platforms, Stay AI keeps the private key viewable after creation, you can return to **Settings → API Keys** and click **Show** any time to see it again. There's no "you only get one chance to copy it" moment.
:::

## Connect the key in Chord

1. Open Chord Hub and go to **Data Sources → Add Source**.
2. Pick **Stay AI** from the data source list.
3. Paste the API key you just copied into the **API Key** field.
4. Click **Save.** Chord makes a test call against the Stay AI subscriptions endpoint to confirm the key works.
5. The first sync kicks off automatically; subsequent syncs run on your tenant's standard ingestion schedule.

## Troubleshooting

**What does the validate step actually check?**
Chord makes a small read against `https://api.retextion.com/api/v2/subscriptions` and confirms the key returns a 200 response with no authorization error. It does not pull or store any records, that happens on the first scheduled sync after you save the credential.

**The validate step failed. What now?**
Stay AI API keys don't have scopes, so a 401 means the key value itself is wrong, was revoked, or was copied with extra whitespace. Go back to **Settings → API Keys** in the Stay AI portal, confirm the key is still listed and active, and either copy it again carefully or generate a new one. Paste the value into the same Chord credential entry and test again.

**Do Stay AI API keys expire?**
No. Keys stay valid until someone with portal admin access manually revokes them in **Settings → API Keys**. If a previously working key suddenly fails, check that page first to confirm it's still listed and active.

**How do I rotate the key?**
Generate a new API key in Stay AI, paste it into the same Chord credential entry, and save. Chord uses the new key on the next scheduled sync. Once you've confirmed the new key validates and the next sync runs cleanly, delete the old key from Stay AI.

**Who can see the key after it's saved in Chord?**
The key value is encrypted at rest in Chord Hub and is never displayed back in the UI. You can rotate or delete it any time, but you can't view the original value once it's saved.

**Why does the API host say&#x20;**`retextion.com`**?**
Stay AI was previously called Retextion. The product was rebranded but the underlying API host and authentication header (`X-RETEXTION-ACCESS-TOKEN`) still use the legacy name. This is expected. Chord's connector handles the naming difference internally; you only ever interact with "Stay AI" in the Chord Hub UI.

***

**Need help?** If you hit a credential or connectivity issue you can't resolve, reach out to [help@chord.co](mailto\:help@chord.co) with the exact error message. We'll trace the request and tell you what's failing.
