Connect a Google Workspace
One admin approval lists every mailbox and alias in the Workspace; pick the ones that should send. No passwords, no per-mailbox login.
Ask for the delegation values
curl -X POST "https://app.argorant.com/api/v1/inboxes/google-workspace" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
-d '{"admin_email":"admin@yourdomain.com"}'Before delegation is granted the response carries setup.client_id and setup.scopes with mailboxes: null.
Grant it in Google Admin
Google Admin → Security → Access and data control → API controls → Domain-wide delegation → Add new. Paste the client id and the scopes exactly as returned. This is done once per Workspace by an admin.
List and connect
Call the same endpoint again: it now returns every mailbox and alias. Then pass the addresses to connect (or an empty list for all):
curl -X POST "https://app.argorant.com/api/v1/inboxes/google-workspace" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
-d '{"admin_email":"admin@yourdomain.com","emails":["elena@yourdomain.com","marina@yourdomain.com"]}'
# → { "connected": [ { "email": "elena@yourdomain.com", "health": "healthy" }, ... ] }Connected mailboxes appear in GET /api/v1/inboxes with health, daily limit and today's sends, and can be attached to any campaign. Terminal: argorant inboxes connect-google --admin admin@yourdomain.com [--emails a,b | --all].