Connect 100+ APIs Instantly with the Maton API Gateway Skill
Connect 100+ APIs Instantly with the Maton API Gateway Skill
If you've ever struggled with OAuth flows, token management, or API authentication headaches when building AI workflows, the Maton API Gateway skill is about to change your life. This powerful ClawdHub skill acts as a universal passthrough proxy for 100+ third-party APIs鈥攈andling all the OAuth complexity so you can focus on what matters: getting things done.
What Problem Does This Solve?
Every time you want your AI agent to interact with external services鈥擲lack, HubSpot, Salesforce, Google Sheets, Airtable, Linear鈥攜ou typically need to:
- Register an OAuth app with each provider
- Implement the OAuth dance (redirect URLs, token exchange, refresh logic)
- Store credentials securely
- Handle token expiration and refresh
The API Gateway skill eliminates all of this. You authenticate once via Maton's web interface, and your agent gains instant access to native APIs across 100+ platforms using a single API key.
Installation
Getting started takes just one command:
```bash clawdhub install api-gateway ```
Configuration
The skill requires a single environment variable:
```bash export MATON_API_KEY="your_api_key_here" ```
Getting your API key:
- Sign up or log in at maton.ai
- Navigate to maton.ai/settings
- Copy your API key from the settings page
Add this to your shell profile (`.bashrc`, `.zshrc`) or your Clawdbot environment configuration for persistence.
Usage Examples
The gateway proxies native API endpoints, so you use each service's actual API documentation. The URL format is simple:
``` https://gateway.maton.ai/{app}/{native-api-path} ```
Example 1: Post to Slack
```python import urllib.request, os, json
data = json.dumps({ 'channel': 'C0123456', 'text': 'Hello from my AI agent!' }).encode()
req = urllib.request.Request( 'https://gateway.maton.ai/slack/api/chat.postMessage', data=data, method='POST' ) req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json')
response = json.load(urllib.request.urlopen(req)) print(json.dumps(response, indent=2)) ```
Example 2: Create a HubSpot Contact
```python import urllib.request, os, json
data = json.dumps({ 'properties': { 'email': 'prospect@company.com', 'firstname': 'Jane', 'lastname': 'Doe' } }).encode()
req = urllib.request.Request( 'https://gateway.maton.ai/hubspot/crm/v3/objects/contacts', data=data, method='POST' ) req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json')
response = json.load(urllib.request.urlopen(req)) ```
Example 3: Read from Google Sheets
```python import urllib.request, os, json
spreadsheet_id = 'your_spreadsheet_id' range_name = 'Sheet1!A1:D10'
req = urllib.request.Request( f'https://gateway.maton.ai/google-sheets/v4/spreadsheets/{spreadsheet_id}/values/{range_name}' ) req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
response = json.load(urllib.request.urlopen(req)) print(response['values']) ```
Managing Connections
Before using an API, you need to connect it via OAuth. The skill provides connection management endpoints:
List existing connections:
```bash
curl -s 'https://ctrl.maton.ai/connections'
-H "Authorization: Bearer $MATON_API_KEY" | jq
```
Create a new connection:
```bash
curl -X POST 'https://ctrl.maton.ai/connections'
-H "Authorization: Bearer $MATON_API_KEY"
-H 'Content-Type: application/json'
-d '{"app": "linear"}'
```
This returns a URL鈥攐pen it in your browser to complete the OAuth flow. Once connected, you can immediately use that service's API.
Multiple accounts: If you have multiple connections for the same app (e.g., two Slack workspaces), specify which one using the `Maton-Connection` header with the connection ID.
Supported Services
The gateway supports a massive range of services including:
- Productivity: Slack, Notion, Linear, Asana, ClickUp, Monday.com, Trello, Todoist
- CRM/Sales: HubSpot, Salesforce, Pipedrive, Attio, Apollo
- Google Workspace: Gmail, Calendar, Drive, Sheets, Docs, Forms, Meet
- Microsoft: Outlook, Excel, OneDrive, To Do
- Marketing: Mailchimp, Klaviyo, ActiveCampaign, Brevo, Kit
- Developer: GitHub, Netlify, Firebase, Linear, Jira, Confluence
- Payments: Stripe, Square, QuickBooks, Xero
- Communication: Twilio, Telegram, WhatsApp Business
- And 70+ more...
Pro Tips
-
Use native API docs: Since the gateway is a passthrough, use each service's official API documentation for endpoints, parameters, and response formats.
-
Check connection status: Before making API calls, verify your connections are active: ```bash curl -s 'https://ctrl.maton.ai/connections?status=ACTIVE'
-H "Authorization: Bearer $MATON_API_KEY" ``` -
Handle errors gracefully: The gateway passes through native API errors, so check response status codes and error messages from each provider.
-
Start with read operations: When connecting a new service, start with GET requests to verify your connection works before attempting writes.
Conclusion
The Maton API Gateway skill removes the authentication burden from integrating external services into your AI workflows. With one API key and one OAuth flow per service, you get direct access to native APIs across the modern SaaS ecosystem.
Stop building OAuth flows. Start building automations.
Links:
Comments (0)
No comments yet. Be the first to comment!