Connectors & Credentials
Connectors link services outside Gridie — like Stripe, BigQuery, or Hometax — to the agent so it can pull in data or send emails and messages. Once connected, you can work with external data in plain language, such as “Pull last month’s Stripe payments.”
What Is a Connector?
A connector turns an external service into a tool the agent can use. When a service is connected, the agent can query its data or perform actions through it. Only activated connectors are exposed to the agent, though — tools from services you haven’t connected stay hidden.
Two Authentication Methods
How you connect a service depends on its authentication method.
OAuth
Connect by approving access on the service’s login screen — no key to enter. Go to User menu → Settings → Integrations and click Connect on the service card.
- Services: Gmail, Google Drive, Google Analytics, BigQuery, Slack
Auth key
Register an API key, account info, or a certificate file issued by the service. The credential you register is stored encrypted and attached to the connectors that use it.
- API key: Stripe, Resend, Bolta, Spendit, ECOUNT, SAP OData
- Account info: Bank, E-commerce
- Certificate: Hometax, Bank, Social Insurance
Public data sources like DART, stock quotes, and SEC EDGAR can be used right away with no authentication.
Connectable Services
| Service | Description | Auth |
|---|---|---|
| Gmail | Send email from your Google account | OAuth |
| Resend | Send email from a custom domain | API key |
Files & Data
| Service | Description | Auth |
|---|---|---|
| Google Drive | Import files from Google Drive | OAuth |
| Google Analytics | GA4 traffic, user behavior, and reports | OAuth |
| BigQuery | Explore datasets/tables and run SQL | OAuth |
| Slack | Send messages, look up channels/users, search | OAuth |
Disclosures & Market
| Service | Description | Auth |
|---|---|---|
| DART | Korean listed-company financials and filings | None |
| SEC EDGAR | US filings and XBRL financial data | None |
Finance & Payments
| Service | Description | Auth |
|---|---|---|
| Stripe | Customers, payments, subscriptions, invoices, balance | API key |
| Hometax | Tax invoice and cash-receipt sales/purchase data | Certificate |
| Bank | Balances and transactions (KB, Shinhan, Hana, Woori, etc.) | Account info / Certificate |
| Bolta | Issue and look up electronic tax invoices | API key |
ERP & Expenses
| Service | Description | Auth |
|---|---|---|
| ECOUNT ERP | Sales, purchasing, inventory, production, accounting | API key |
| SAP OData | S/4HANA sales, purchasing, production, inventory, accounting | API key |
| Spendit | Expense reports and spending data | API key |
| Social Insurance | Subscriber roster lookup | Certificate |
| E-commerce | PG sales data (Baemin, Coupang, Naver, 11st, etc.) | Account info |
Supported connectors are added continuously, and some may not appear depending on region (domestic/global). Check the live list in the app.
Registering an Auth Key
Auth-key services require a credential before you can use them. What you enter depends on the service, and a registration form tailored to each service is provided.
Register with an API key
Open the registration screen
Open the credential registration screen for the service you want to connect.
Enter the key
Paste the API key or auth info issued by the service. (e.g., Stripe → Dashboard → Developers → API keys → secret key sk_live_...)
Save
Saving completes the connection.
Register with a certificate (NPKI)
For services that need a certificate — like Hometax, Bank, and Social Insurance — register it like this.
Select the certificate folder
Select the entire certificate folder containing the .der (signing certificate) and .key (private key) files. If you’re not sure where it is, see the certificate folder location guide on the registration screen.
Enter the certificate password
Enter the certificate password. The certificate is encrypted with this password before being stored.
Enter the business registration number
Enter the business registration number if required.
A single credential can be shared by multiple connectors. For example, registering one certificate lets you use it across Hometax, Bank, and Social Insurance.
Turning Connectors On in Chat
Click the connector button below the chat input to choose which services to use, then type your request. Only the tools of activated connectors are available in that conversation.
Security & Disconnecting
- Every registered credential is stored encrypted, and certificates are encrypted with the password you provide.
- Credentials are used only within the folder where they’re registered and are never exposed to users without access.
- Disconnecting or deleting a credential doesn’t affect data you’ve already imported, but you won’t be able to pull new data from that service afterward.
API keys and certificates are sensitive. Register them only for the connectors you actually need, and delete credentials you no longer use.
Custom Connectors (MCP)
For services not on the list, connect an external MCP server yourself and use it as a custom connector. See the custom connectors (MCP) guide for details.
Custom Connectors (MCP)