bring your own discovery (agent + tool imports)
pipe creators or leads found by ANY external tool - content-analysis engines like Lightreel, scrapers, spreadsheets, your own agent - into iris as the outreach system of record.
steps
import your roster in one call
POST /contacts/bulk with up to 500 contacts. email is optional - handle-only creators are first-class: set instagram_handle, twitter_handle, or tiktok_handle per contact. pass campaign_id at the top level to attach every import to a campaign, or per-contact campaign_ids for mixed targeting. set source to your tool's name (e.g. 'lightreel', 'api') for per-source attribution.
imports are idempotent: duplicates merge by email or social handle (case-insensitive, @ stripped), including within one request - safe to retry.
store your tool's intel on the contact
put per-contact research (content niche, standout posts, why they fit) in enrichment_data (up to 50KB JSON) and tags. /ai/generate reads both automatically when drafting - your tool's judgment personalizes every message without prompt-smuggling.
verify what landed
GET /contacts/:id/handles echoes the saved social handles; GET /usage shows contact-slot headroom before your next batch.
draft and deliver
activate the campaign (or add contacts to an active one) and iris drafts per contact - format:'dm' produces platform-native DMs. email/instagram/twitter deliver via the API; tiktok drafts use the manual flow: copy, send on-platform, then POST /messages/:id/mark-sent so the CRM records it.
record inbound replies with POST /conversations/:id/messages (direction 'inbound') to keep the thread complete.
ready to get started?
sign up in seconds. free to start, no credit card required.