⚡API

API Keys let you access Ring Tonic data programmatically. Use them to build custom integrations, sync call data with your CRM, or power dashboards.

API Keys are available on the Agency plan only.

---

Creating an API Key

1. Go to Settings → API Keys

2. Enter a descriptive name (e.g., "SEO Utils Integration")

3. Click Create API Key

4. Copy your key immediately — you won't see it again

Store your key securely. Treat it like a password. Anyone with your key can access your data.

---

Using Your API Key

Include the key in the Authorization header of all requests:

curl "https://ringtonic.app/api/v1/campaigns/{campaign_uuid}/geo-data" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

---

Managing Keys

Action	How
View keys	Settings → API Keys
See last used	Check the "Last Used" column
Revoke key	Click the trash icon → Confirm

Revoking is permanent. Any integrations using that key will immediately stop working.

---

Available Endpoints

Click here for full documentation. (Updating...)

---

Common Questions

How many API keys can I create?

Unlimited. Create separate keys for each integration so you can revoke them independently.

Do API keys expire?

No. Keys remain active until you revoke them.

What happens if my key is compromised?

Revoke it immediately from Settings → API Keys and create a new one.