Connect Google Workspace
Connect a Gmail account, the Google Drive folder for shipment documents, and a Google Sheet. The agent then reads shipment mail, files documents and keeps your sheet up to date.
Before you start
| What | Who |
|---|---|
A Google Workspace account for the agent, e.g. shipments@yourcompany.com | Your Google Workspace admin |
| If your organization restricts third-party apps: mark Threadship as trusted in the Google Admin console under Security → API controls | Your Google Workspace admin |
| A Threadship admin account | Your Threadship admin |
1. Connect the agent's account
- Go to agent.threadship.ai and choose Continue with Google.
- In setup (or on the team's Agent page), choose Connect a Google account and sign in as the agent's account.
- Leave every permission ticked on Google's consent screen: reading mail and working with Drive files.
2. Choose the folder
- In Google Drive, share the folder for shipment documents with the agent's account.
- Choose Choose folder and pick it, or paste the folder's link and choose Add.
The agent reads and saves files only inside the folders you choose.
3. Connect a Google Sheet
- Keep the sheet in a folder you chose, with its column headers in row 1.
- Pick it from the list and choose Connect.
The agent fills only the columns it recognizes and never touches your other columns.
4. Add your partners
On the Agent page, under Add a partner, enter your suppliers' and forwarders' addresses or domains. Mail from anyone else waits in Mail to review.
What the agent can access
| Scope | Purpose |
|---|---|
| gmail.readonly | Read mail the agent's account receives. It can't send, delete or change mail. |
| drive | Read and save files, limited by Threadship to the folders you choose. |
| openid, email, profile | Confirm which account was connected. |
Disconnecting
On the Agent page, choose Disconnect. Threadship stops watching the mailbox and revokes its access; shipments, documents and the team's memory stay. You can also remove Threadship from the agent's Google Account under Third-party apps & services. More on our Security page.
Questions: support@threadship.ai