Back to Setup Guide

Step 2: Connect AWS Account

Connect Your AWS Account

Link your AWS account to SaneCost in 6 steps using CloudFormation. Takes about 3 minutes.

Before You Start

  • SaneCost installed in your Slack workspace
  • Access to the AWS account you want to monitor
  • Permission to create CloudFormation stacks (IAM roles)
01

Run the Connect Command in Slack

Open any channel in your Slack workspace and type the slash command. Slack will show a command picker — select /sanecost, then type connect aws.

/sanecost connect aws
your-channel
SC

SaneCost APP · just now

Add Another AWS Account

Quick Setup Instructions:
  1. Click the button below to open AWS CloudFormation
  2. Review the pre-filled stack details
  3. Check the acknowledgment box
  4. Click 'Create Stack'
  5. Wait 2-3 minutes for completion
Launch CloudFormation Stack

Tip: Type / first to trigger the command picker, then click on /sanecost from the dropdown. This ensures Slack recognizes it as a slash command.

02

Click "Launch CloudFormation Stack"

This opens the AWS CloudFormation console in a new browser tab. If you're signed into multiple AWS accounts, you'll see an account picker — select the account you want to monitor.

aws Choose your AWS session

Choose your AWS session

You have active sessions. Choose the account you want to monitor:

Your AWS Account (1234-5678-9012) Click to select →

Important: Make sure you select the correct AWS account. SaneCost will only monitor the account where the CloudFormation stack is deployed.

03

Review the Pre-Filled Template

CloudFormation opens with everything pre-configured. You'll see the stack name, template URL, and parameters — all filled in automatically by SaneCost. You don't need to change anything.

aws CloudFormation > Stacks > Quick create stack

Stack name

SaneCost-XXXXX-XXXXXX

Parameters

WorkspaceId T0XXXXXXXXX
SaneCostAccountId 997392827253
SaneCostRegion eu-west-1
EnableWriteActions true

What do these parameters mean? WorkspaceId links this AWS account to your Slack workspace. SaneCostAccountId is SaneCost's AWS account for cross-account monitoring. EnableWriteActions lets SaneCost stop instances (only with your explicit approval via Slack).

04

Check the IAM Acknowledgment & Create Stack

Scroll to the bottom. You'll see a Capabilities section with a checkbox. This is standard CloudFormation — it's confirming that the template will create IAM roles (the read-only monitoring role SaneCost needs).

aws Capabilities
I acknowledge that AWS CloudFormation might create IAM resources with customised names.
Cancel Create stack

Check the box, then click Create stack. That's it — the deployment takes about 2-3 minutes.

05

Wait for CREATE_COMPLETE

CloudFormation will show the stack status progressing through CREATE_IN_PROGRESS. When it reaches CREATE_COMPLETE, your account is connected. SaneCost automatically registers the account — no further action needed.

aws CloudFormation > Stacks > SaneCost-XXXXX

Stack info

Status CREATE_COMPLETE
Description SaneCost Customer Onboarding
Resources created 6 (IAM roles, Lambda, EventBridge rule)
06

Verify in Slack

Go back to Slack and run the status command to confirm everything is connected:

/sanecost status
your-channel
SC

SaneCost APP · just now

SaneCost Connection Status

Connected Accounts: 1

Account ID: 270313871197
Connected: 2026-03-27 12:50 UTC
Tier: standard
Status: ✅ Active

Success! Your AWS account is now connected and SaneCost will begin monitoring it within the next few minutes.

You're Connected!

SaneCost is now monitoring your AWS account for idle and underutilized resources.

Next step: Set up your notification channel to receive waste alerts.