Connecting Accounts

Stormy integrates with your existing tools to send outreach, track campaigns, and process payments. This guide covers how to connect each integration and best practices for getting the most out of them.

All integrations are managed from Settings > Integrations in your workspace.

---

Gmail Connection

Gmail is the most important integration in Stormy. It powers your outreach sequences, syncs replies to your inbox, and gives the AI agent access to conversation history.

How It Works

• Stormy connects to Gmail via OAuth 2.0 — you authorize specific permissions, and Stormy never sees or stores your password
• Emails are sent from your real Gmail address (or Google Workspace address)
• Replies from creators land in both your Gmail inbox and the Stormy AI Inbox
• Stormy syncs email threads bidirectionally — if you reply from Gmail directly, the conversation still appears in Stormy

Connecting Gmail

1. Go to Settings > Integrations
2. Find the Gmail card and click Connect
3. A Google OAuth window opens — select the Google account you want to use
4. Review the permissions Stormy requests:
   • Send email on your behalf — required for outreach sequences
   • Read email messages — required for syncing replies and conversation history
   • Manage drafts — required for the AI agent to create draft responses
5. Click Allow
6. You are redirected back to Stormy with a success confirmation

Verifying the Connection

After connecting, Stormy displays your connected email address and connection status on the Integrations page. To verify everything works:

1. Go to Settings > Integrations > Gmail
2. Click Send Test Email
3. Enter your own email address (or a colleague's)
4. Check that the test email arrives and shows as sent from your address

Connecting Multiple Gmail Accounts

You can connect more than one Gmail account to a workspace. This is useful when:

• Different team members send from their own addresses
• You have separate addresses for different campaign types (e.g., partnerships@yourco.com and collabs@yourco.com)
• You want to distribute sending volume across multiple accounts to protect deliverability

To add another account, click Connect Another Account on the Gmail integration page and repeat the OAuth flow.

Gmail Sending Limits

Google enforces daily sending limits that vary by account type:

Account Type	Daily Sending Limit
Free Gmail (@gmail.com)	500 emails/day
Google Workspace	2,000 emails/day
Google Workspace (new domain)	Starts at ~100/day, ramps up over time

Stormy's rate limiter respects these limits automatically. If you approach the limit, Stormy queues remaining emails for the next day rather than risking a bounce or account suspension.

---

Email Warmup

If you are using a new email address or a domain with little sending history, you should warm it up before launching outreach sequences. Email warmup gradually builds your sender reputation with email providers (Gmail, Outlook, etc.) so your messages land in inboxes instead of spam folders.

How Stormy's Warmup Works

1. Stormy sends a small number of emails per day from your account to a network of warmup addresses
2. Those addresses automatically open, read, and reply to your emails — signaling to email providers that your messages are wanted
3. If any of your emails land in spam, the warmup network moves them to the inbox and marks them as "not spam"
4. Over 2-3 weeks, sending volume gradually increases from ~5/day to ~40/day
5. After warmup completes, your account has enough positive signals to support outreach campaigns

Enabling Warmup

1. Go to Settings > Integrations > Gmail
2. Find the connected account you want to warm up
3. Toggle Email Warmup to on
4. Choose your warmup schedule:
   • Conservative (3 weeks): Best for brand-new domains, starts at 3 emails/day
   • Standard (2 weeks): Good for established domains with a new address, starts at 5 emails/day
   • Aggressive (10 days): For domains with existing reputation, starts at 10 emails/day

Warmup Best Practices

• Start warmup before you need it. Enable it as soon as you connect a new Gmail account, even if you are not ready to send outreach yet.
• Do not skip warmup for new domains. A brand-new domain (registered in the last 30 days) sending 100 cold emails on day one is almost guaranteed to land in spam.
• Keep warmup running. Even after the initial ramp-up, keeping warmup active at a low level (5-10 emails/day) helps maintain your sender reputation during quiet periods.
• Set up SPF, DKIM, and DMARC on your domain before warming up. These DNS records prove to email providers that you are authorized to send from your domain. Your IT team or domain registrar can help with this.

---

Instagram Connection

Connecting Instagram allows Stormy to track posts where creators mention your brand, monitor story tags, and pull engagement metrics for campaign reporting.

What It Enables

• Post Tracking: Automatically detect when a creator publishes sponsored content mentioning your brand
• Engagement Metrics: Pull likes, comments, saves, shares, and estimated reach for tracked posts
• Story Monitoring: Detect story mentions and capture them before they expire (24 hours)
• Content Library: Save creator content for reporting and internal review

Connecting Instagram

1. Go to Settings > Integrations
2. Click Connect on the Instagram card
3. Log in with your Instagram Business or Creator account
4. Authorize Stormy to access your public profile and media insights
5. Confirm the connection

Tracking Creator Posts

Once connected, you can set up post tracking for specific campaigns:

1. Go to Post Tracking from the sidebar
2. Click New Campaign Tracker
3. Define your tracking criteria:
   • Brand mentions: Your Instagram @handle
   • Hashtags: Campaign-specific hashtags (e.g., #StormyPartner)
   • Creator accounts: Specific creator handles to monitor
4. Stormy checks for new matching posts every 30 minutes and pulls in metrics

---

TikTok Connection

Similar to Instagram, connecting TikTok enables post tracking and engagement analytics for TikTok creator campaigns.

What It Enables

• Video Tracking: Monitor creator videos that mention your brand or use campaign hashtags
• Performance Metrics: Views, likes, comments, shares, and estimated reach
• Hashtag Challenge Tracking: Track branded hashtag performance across all creators

Connecting TikTok

1. Go to Settings > Integrations
2. Click Connect on the TikTok card
3. Log in with your TikTok Business account
4. Authorize the connection
5. Verify by checking the connection status

---

Shopify Integration

The Shopify integration connects your store to Stormy, enabling you to track creator-driven sales, generate unique discount codes, and measure campaign ROI with real revenue data.

What It Enables

• Revenue Attribution: Track sales generated by specific creators through unique discount codes or UTM links
• Discount Code Generation: Create unique codes per creator directly from Stormy
• Order Tracking: See which orders came from influencer campaigns
• ROI Dashboards: Compare creator spend vs. revenue generated

Connecting Shopify

1. Go to Settings > Integrations
2. Click Connect on the Shopify card
3. Enter your Shopify store URL (e.g., your-store.myshopify.com)
4. You will be redirected to Shopify to authorize the Stormy app
5. Review the permissions and click Install App
6. You are redirected back to Stormy with the connection confirmed

Setting Up Creator Discount Codes

Once Shopify is connected, you can generate unique discount codes per creator:

1. Open a creator's profile from any list
2. Go to the Deals tab
3. Click Generate Discount Code
4. Configure the discount:
   • Discount type: Percentage off or fixed amount
   • Discount value: e.g., 15% or $10
   • Code prefix: Optional prefix (e.g., CREATOR15-)
   • Usage limit: Maximum number of times the code can be used
   • Expiration: When the code expires
5. Stormy creates the code in your Shopify store and associates it with the creator's profile

Revenue Attribution

Stormy tracks revenue from creator campaigns in two ways:

1. Discount codes: When a customer uses a creator's unique discount code, the order is attributed to that creator
2. UTM links: When a customer arrives via a UTM-tagged link (e.g., ?utm_source=stormy&utm_medium=influencer&utm_campaign=creator-name), Stormy attributes the session and any resulting orders

Both methods feed into the Campaign Dashboards where you can see:

• Total revenue per creator
• Cost per acquisition (CPA)
• Return on ad spend (ROAS)
• Average order value (AOV) from influencer traffic

---

Payment Methods (CreatorPay)

To pay creators through Stormy's CreatorPay system, you need to set up a payment method.

Connecting a Payment Method

1. Go to Settings > Billing > Payment Methods
2. Click Add Payment Method
3. Enter your credit card or bank account details
4. Stormy uses Stripe for payment processing — your details are stored securely by Stripe, never on Stormy's servers

Paying Creators

Once a payment method is connected, you can:

• Send one-time payments to creators from their profile
• Set up milestone-based payments tied to deliverables
• Configure performance bonuses that auto-calculate based on tracked metrics (views, clicks, sales)
• Generate invoices that creators can download for their records

See the full CreatorPay documentation for detailed setup and configuration.

---

Connection Health and Troubleshooting

Checking Connection Status

Go to Settings > Integrations to see the status of all your connections at a glance:

Status	Meaning
Connected (green)	Integration is active and working
Needs Reauthorization (yellow)	OAuth token expired — click to re-authenticate
Error (red)	Something went wrong — check the error message for details
Not Connected (gray)	Integration has not been set up yet

Common Issues

Gmail shows "Needs Reauthorization"

This happens when your Google OAuth token expires (typically every few months) or if you changed your Google password. To fix it:

1. Click the Gmail integration card
2. Click Reconnect
3. Complete the OAuth flow again

Instagram or TikTok connection is not tracking posts

• Verify that the creator posted with the correct @mention or hashtag
• Check that the post is on a public account (private accounts cannot be tracked)
• Post tracking polls every 30 minutes — wait at least an hour before troubleshooting
• For Instagram Stories, tracking must be set up before the story is posted (stories cannot be retroactively detected after expiration)

Shopify discount codes are not syncing

• Verify your Shopify connection is still active (check for "Connected" status)
• Make sure the discount code was created through Stormy, not directly in Shopify
• Check that the Stormy app still has the required permissions in your Shopify admin under Settings > Apps and sales channels

Emails are landing in spam

This is usually a sender reputation issue, not a connection issue. Steps to resolve:

1. Enable email warmup if you have not already
2. Verify SPF, DKIM, and DMARC are configured on your domain
3. Reduce sending volume temporarily (lower your sequence's daily sending limit)
4. Review your email content for spam trigger phrases (excessive capitalization, too many links, aggressive CTAs)
5. Check your domain on Google Postmaster Tools for reputation insights

---

Recommended Setup Order

For the best experience, connect your integrations in this order:

1. Gmail — This is required for any outreach. Connect it first and enable warmup if needed.
2. Shopify (if applicable) — Connect before launching campaigns so discount codes and attribution are ready from day one.
3. Instagram — Connect before creators start posting so post tracking catches everything.
4. TikTok — Same as Instagram, connect before campaign content goes live.
5. Payment Method — Set up before you need to pay creators to avoid delays in partnership timelines.

---

Security and Privacy

How Stormy Handles Your Credentials

• OAuth tokens are encrypted at rest and stored in Stormy's secure backend
• Stormy never stores passwords — all authentication uses OAuth 2.0 (Gmail, Instagram, TikTok) or API keys (Shopify)
• Payment information is stored by Stripe, not by Stormy. Stormy only stores a reference token to your Stripe payment method.
• Access is scoped — each integration only requests the minimum permissions needed for its features

Revoking Access

You can disconnect any integration at any time:

1. Go to Settings > Integrations
2. Click the integration you want to disconnect
3. Click Disconnect
4. Confirm the disconnection

Additionally, you can revoke Stormy's access from the platform side:

• Google: myaccount.google.com/permissions
• Instagram/Meta: Instagram Settings > Apps and Websites
• TikTok: TikTok Settings > Security > Manage app permissions
• Shopify: Shopify Admin > Settings > Apps and sales channels > Remove app