Connect a Google Workspace
Two calls. Without emails you get what the Workspace admin must add in Google Admin (a client id and its access list) and, once that is done, every mailbox and alias in the Workspace. With emails those addresses are connected as senders. No passwords and no sign-in per mailbox.
| Cost | What it does | Key scopes |
|---|---|---|
| Free | Writes | argorant:manage_lists |
Authorization
BearerAuth Your API key from app.argorant.com/profile, sent as Authorization: Bearer <key>. A connector sign-in token (ag_mcp_...) works the same way.
In: header
Header Parameters
Any unique text up to 128 characters. A retry with the same key and the same body within 24 hours returns the first answer (with the header Idempotent-Replayed: true) instead of doing the work twice. The same key with another body answers 409 idempotency_conflict.
length <= 128Your own id for this request, 8 to 64 letters, digits, dot, dash or underscore. Returned as X-Request-Id; one is made for you when you send none.
^[A-Za-z0-9._-]{8,64}$Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://app.argorant.com/api/v1/inboxes/google-workspace" \ -H "Idempotency-Key: 6f1c2e7a-run-42" \ -H "Content-Type: application/json" \ -d '{ "admin_email": "admin@northgate-advisory.com", "emails": [ "elena@northgate-advisory.com" ] }'{ "setup": { "client_id": "104912345678901234567", "scopes_csv": "https://www.googleapis.com/auth/gmail.send,https://www.googleapis.com/auth/gmail.readonly" }, "domains": [ "northgate-advisory.com" ], "mailboxes": [ { "email": "elena@northgate-advisory.com", "name": "Elena Vaughn", "connected": false, "alias": false } ]}