Skip to main content
Instantly connects with a v2 API key. Once connected, the agent can report on cold email campaigns, sending accounts, leads, and campaign analytics — and, with an all:all key, make changes when you ask.

Step 1 — Create a v2 API key

In Instantly, go to Settings → Integrations → API Keys → Create and choose v2. Pick the scope:
  • all:read — reporting only
  • all:all — the agent can also manage campaigns
Copy the key.

Step 2 — Connect in Ryze

On the Integrations page, click Connect on the Instantly card, paste the key into API key (v2), and click Continue.

What the agent can do

  • Read — campaigns and their analytics (sends, opens, replies, bounces, opportunities), sending accounts and warmup health, emails, and leads
  • Change (all:all key) — add leads to a campaign, edit, activate or pause campaigns, and reply to email threads when you ask
  • Delete (all:all key) — delete leads or campaigns when you explicitly ask
By default the agent runs its tools on its own: the Tool approvals setting in the chat composer starts on Skip all approvals. To review changes before they happen, switch it to Approve write & delete (reads run freely, changes need approval) or Manual approve (every tool that touches your data needs approval). Scheduled tasks run without an approval step. Lead searches count as changes too, so with Approve write & delete on you’re also asked to approve them.

Troubleshooting

  • Key rejected — make sure you created a v2 key and copied all of it.
  • Campaign changes are rejected — the key is scoped to all:read. Create a key with all:all, then disconnect Instantly in View and connect again with the new key.
Still stuck? Email support@get-ryze.ai.