Question 1

how do I create my first campaign?

Accepted Answer

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.

Question 2

how does contact discovery work?

Accepted Answer

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.

Question 3

how do I connect my social accounts?

Accepted Answer

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

Question 4

what are objective types?

Accepted Answer

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. the objective determines the wizard flow and discovery strategy.

Question 5

how does AI message generation work?

Accepted Answer

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.

Question 6

can I customize email templates?

Accepted Answer

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.

Question 7

how do I import existing contacts?

Accepted Answer

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.

Question 8

what data sources does discovery use?

Accepted Answer

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

Question 9

what channels does iris support?

Accepted Answer

email (via SendGrid), Instagram DMs, Twitter DMs, and LinkedIn messages. 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.

Question 10

what happens when someone replies?

Accepted Answer

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.

Question 11

what is the email sending limit?

Accepted Answer

message limits are per campaign, not global. starter: 300 messages per campaign, pro: 200, premium: 200. this protects sender reputation and deliverability. the number of campaigns you can create per billing period determines total capacity.

Question 12

what plans are available?

Accepted Answer

iris offers starter, pro, and premium plans with monthly and yearly billing. each plan includes limits for campaigns, contacts, emails, and AI generations per billing period. see the pricing page for current rates.

Question 13

how do I upgrade or cancel?

Accepted Answer

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.

Question 14

does iris have an API?

Accepted Answer

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).

Question 15

how do I get an API key?

Accepted Answer

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.

Question 16

what are x402 and MPP?

Accepted Answer

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 includes 30 contacts, 300 messages, and 50 AI generations. credits never expire and are refunded if campaign creation fails.

Question 17

how do I track campaign performance via API?

Accepted Answer

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.

help

getting started

campaigns

contacts & discovery

channels & messaging

billing

API & integrations