how do I create my first campaign?

navigate to the campaigns page and click 'create campaign'. choose your objective type (venue booking, product promotion, or custom outreach), fill in the details, discover contacts, and activate. iris drafts personalized messages for each contact using AI.

how does contact discovery work?

iris uses Google Maps, web scraping, and social media to find leads based on your criteria. specify your target location, business type, and filters, and iris finds relevant contacts with emails and social handles for your campaigns.

how do I connect my social accounts?

go to settings and click 'connected accounts'. you can link Twitter and Instagram via OAuth. once connected, iris can send DMs and track conversations across all channels.

what are objective types?

campaigns are driven by objectives: 'book DJ gigs' and 'host events' for venue outreach, 'promote a product' for AI-analyzed product marketing with auto-generated target profiles, and 'custom outreach' for your own criteria. iris infers the right objective from your goal description in chat — you don't pick it manually.

how does AI message generation work?

when you activate a campaign, iris uses Claude to draft personalized emails for each contact. it considers the contact's business, your campaign objective, and any product analysis to write relevant outreach. you review and approve drafts before they're sent.

can I customize email templates?

yes. use variables like {{business_name}} and {{contact_name}} to personalize. you can also let the AI generate templates based on your campaign objective and target audience.

how do I import existing contacts?

go to contacts and click 'import'. upload a CSV with columns for business name, email, phone, website, Instagram, and address. download the template first to get the correct format.

what data sources does discovery use?

iris discovers contacts via Google Maps (location-based business search), social media platforms (Instagram, Twitter), and web scraping. each source returns different data — Maps gives addresses and phone numbers, social gives handles and follower counts.

what channels does iris support?

email (via SendGrid), Instagram DMs, and Twitter DMs. each channel has its own adapter for formatting, rate limits, and delivery tracking. the orchestrator picks the best channel per contact based on available handles.

what happens when someone replies?

replies are tracked in the unified inbox. email replies come through SendGrid inbound webhooks, Twitter and Instagram DMs come through platform webhooks. AI can help draft responses, which you review before sending.

what is the email sending limit?

message limits are per campaign, not global. starter: 360 messages per campaign, pro: 480, premium: 720. each campaign's cap scales with its contact size (12× contacts) to cover initial outreach plus follow-ups across email, instagram, and twitter. the number of campaigns you can create per billing period determines total capacity.

what plans are available?

iris offers starter, pro, and premium plans with monthly and yearly billing. each plan caps the number of campaigns and the size of each campaign (contacts and messages); AI drafting and response analysis are bundled in. see the pricing page for current rates.

how do I upgrade or cancel?

go to settings > billing to manage your subscription. you can upgrade, downgrade, or cancel anytime. cancellations take effect at the end of your current billing period.

does iris have an API?

yes. iris has a REST API at api.iris-ai.dev with 80+ endpoints covering campaigns, contacts, conversations, messages, discovery, AI, analytics, billing, and webhooks. authenticate with API keys (is_live_...) or agent payment protocols (x402, MPP).

how do I get an API key?

go to settings > API keys and click 'generate key'. choose the scopes you need (campaigns:read, contacts:write, etc.) and set an expiration. the raw key is only shown once — save it securely.

what are x402 and MPP?

x402 and MPP are agent payment protocols that let AI agents use the iris API without an API key. x402 agents pay per-campaign ($2.25). MPP agents buy credit packs (5 for $12.00). each campaign credit unlocks the starter envelope: 30 contacts and 360 messages, with AI drafting bundled in. credits never expire and are refunded if campaign creation fails.

how do I track campaign performance via API?

the analytics endpoints provide open rates, click rates, response rates, and conversions. filter by date range and campaign. webhook subscriptions can push events to your server in real-time.

guides

intermediatesetup15 minutes (plus DNS propagation)

verify your sender domain

set up SPF, DKIM, and DMARC for your domain so emails from iris land in inboxes, not spam folders.

steps

open settings → email domain

iris generates a personalized list of DNS records for your domain. they're specific to your account - don't copy-paste records from another tutorial.

add the records to your DNS provider

log into your DNS provider (Cloudflare, Namecheap, GoDaddy, Google Domains, etc.) and add each record exactly as iris shows it. there are typically three records: one for SPF, one for DKIM, and one for DMARC.

DNS providers often append your domain automatically. if iris says the host is `mail._domainkey`, don't paste `mail._domainkey.yourdomain.com` - the provider adds the domain for you.

wait for propagation

DNS changes can take anywhere from a few minutes to a few hours to propagate. iris will check the records automatically and flip the domain to 'verified' once they resolve.

send a test email

once verified, iris will let you send a test email to your own inbox before you activate any campaign. confirm it lands in the primary inbox (not spam) before running a campaign at scale.

why this matters

SPF, DKIM, and DMARC are the three signals inboxes use to decide whether an email is legitimate. without them, your messages from iris look unauthenticated and get routed to spam.

SPF tells inboxes which servers are allowed to send mail on behalf of your domain.
DKIM cryptographically signs each email so recipients can verify it wasn't tampered with.
DMARC tells inboxes what to do if SPF or DKIM fail (typically: reject or quarantine).

iris doesn't ask you to give it your domain credentials. you add three records on your side; iris validates them on its side. if you ever stop using iris, the records sit there harmlessly until you remove them.

ready to get started?

get started free sign in