API Gateway
Passthrough proxy for direct access to third-party APIs using managed OAuth connections, provided by Maton. The API gateway lets you call native API endpoints directly.
Quick Start
# Native Slack API call
python <<'EOF'
import urllib.request, os, json
data = json.dumps({'channel': 'C0123456', 'text': 'Hello from gateway!'}).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')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Base URL
https://gateway.maton.ai/{app}/{native-api-path}
Replace {app} with the service name and {native-api-path} with the actual API endpoint path.
IMPORTANT: The URL path MUST start with the connection's app name (eg. /google-mail/...). This prefix tells the gateway which app connection to use. For example, the native Gmail API path starts with gmail/v1/, so full paths look like /google-mail/gmail/v1/users/me/messages.
Authentication
All requests require the Maton API key in the Authorization header:
Authorization: Bearer $MATON_API_KEY
The API gateway automatically injects the appropriate OAuth token for the target service.
Environment Variable: You can set your API key as the MATON_API_KEY environment variable:
export MATON_API_KEY="YOUR_API_KEY"
Getting Your API Key
- Sign in or create an account at maton.ai
- Go to maton.ai/settings
- Click the copy button on the right side of API Key section to copy it
Connection Management
Connection management uses a separate base URL: https://ctrl.maton.ai
List Connections
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=slack&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Query Parameters (optional):
app - Filter by service name (e.g., slack, hubspot, salesforce)
status - Filter by connection status (ACTIVE, PENDING, FAILED)
Response:
{
"connections": [
{
"connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80",
"status": "ACTIVE",
"creation_time": "2025-12-08T07:20:53.488460Z",
"last_updated_time": "2026-01-31T20:03:32.593153Z",
"url": "https://connect.maton.ai/?session_token=5e9...",
"app": "slack",
"method": "OAUTH2",
"metadata": {}
}
]
}
Create Connection
python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'slack'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Request Body:
app (required) - Service name (e.g., slack, notion)
method (optional) - Connection method (API_KEY, BASIC, OAUTH1, OAUTH2, MCP)
Get Connection
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Response:
{
"connection": {
"connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80",
"status": "ACTIVE",
"creation_time": "2025-12-08T07:20:53.488460Z",
"last_updated_time": "2026-01-31T20:03:32.593153Z",
"url": "https://connect.maton.ai/?session_token=5e9...",
"app": "slack",
"metadata": {}
}
}
Open the returned URL in a browser to complete OAuth.
Delete Connection
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Specifying Connection
If you have multiple connections for the same app, you can specify which connection to use by adding the Maton-Connection header with the connection ID:
python <<'EOF'
import urllib.request, os, json
data = json.dumps({'channel': 'C0123456', 'text': 'Hello!'}).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')
req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
If omitted, the gateway uses the default (oldest) active connection for that app.
Supported Services
| Service |
App Name |
Base URL Proxied |
| ActiveCampaign |
active-campaign |
{account}.api-us1.com |
| Acuity Scheduling |
acuity-scheduling |
acuityscheduling.com |
| Airtable |
airtable |
api.airtable.com |
| Apollo |
apollo |
api.apollo.io |
| Asana |
asana |
app.asana.com |
| Attio |
attio |
api.attio.com |
| Basecamp |
basecamp |
3.basecampapi.com |
| Baserow |
baserow |
api.baserow.io |
| beehiiv |
beehiiv |
api.beehiiv.com |
| Box |
box |
api.box.com |
| Brevo |
brevo |
api.brevo.com |
| Calendly |
calendly |
api.calendly.com |
| Cal.com |
cal-com |
api.cal.com |
| CallRail |
callrail |
api.callrail.com |
| Chargebee |
chargebee |
{subdomain}.chargebee.com |
| ClickFunnels |
clickfunnels |
{subdomain}.myclickfunnels.com |
| ClickSend |
clicksend |
rest.clicksend.com |
| ClickUp |
clickup |
api.clickup.com |
| Clockify |
clockify |
api.clockify.me |
| Coda |
coda |
coda.io |
| Confluence |
confluence |
api.atlassian.com |
| CompanyCam |
companycam |
api.companycam.com |
| Cognito Forms |
cognito-forms |
www.cognitoforms.com |
| Constant Contact |
constant-contact |
api.cc.email |
| Dropbox |
dropbox |
api.dropboxapi.com |
| Dropbox Business |
dropbox-business |
api.dropboxapi.com |
| ElevenLabs |
elevenlabs |
api.elevenlabs.io |
| Eventbrite |
eventbrite |
www.eventbriteapi.com |
| Exa |
exa |
api.exa.ai |
| Fathom |
fathom |
api.fathom.ai |
| Firebase |
firebase |
firebase.googleapis.com |
| Fireflies |
fireflies |
api.fireflies.ai |
| GetResponse |
getresponse |
api.getresponse.com |
| Grafana |
grafana |
User's Grafana instance |
| GitHub |
github |
api.github.com |
| Gumroad |
gumroad |
api.gumroad.com |
| Granola MCP |
granola |
mcp.granola.ai |
| Google Ads |
google-ads |
googleads.googleapis.com |
| Google BigQuery |
google-bigquery |
bigquery.googleapis.com |
| Google Analytics Admin |
google-analytics-admin |
analyticsadmin.googleapis.com |
| Google Analytics Data |
google-analytics-data |
analyticsdata.googleapis.com |
| Google Calendar |
google-calendar |
www.googleapis.com |
| Google Classroom |
google-classroom |
classroom.googleapis.com |
| Google Contacts |
google-contacts |
people.googleapis.com |
| Google Docs |
google-docs |
docs.googleapis.com |
| Google Drive |
google-drive |
www.googleapis.com |
| Google Forms |
google-forms |
forms.googleapis.com |
| Gmail |
google-mail |
gmail.googleapis.com |
| Google Merchant |
google-merchant |
merchantapi.googleapis.com |
| Google Meet |
google-meet |
meet.googleapis.com |
| Google Play |
google-play |
androidpublisher.googleapis.com |
| Google Search Console |
google-search-console |
www.googleapis.com |
| Google Sheets |
google-sheets |
sheets.googleapis.com |
| Google Slides |
google-slides |
slides.googleapis.com |
| Google Tasks |
google-tasks |
tasks.googleapis.com |
| Google Workspace Admin |
google-workspace-admin |
admin.googleapis.com |
| HubSpot |
hubspot |
api.hubapi.com |
| Instantly |
instantly |
api.instantly.ai |
| Jira |
jira |
api.atlassian.com |
| Jobber |
jobber |
api.getjobber.com |
| JotForm |
jotform |
api.jotform.com |
| Kaggle |
kaggle |
api.kaggle.com |
| Keap |
keap |
api.infusionsoft.com |
| Kibana |
kibana |
User's Kibana instance |
| Kit |
kit |
api.kit.com |
| Klaviyo |
klaviyo |
a.klaviyo.com |
| Lemlist |
lemlist |
api.lemlist.com |
| Linear |
linear |
api.linear.app |
| LinkedIn |
linkedin |
api.linkedin.com |
| Mailchimp |
mailchimp |
{dc}.api.mailchimp.com |
| MailerLite |
mailerlite |
connect.mailerlite.com |
| Mailgun |
mailgun |
api.mailgun.net |
| ManyChat |
manychat |
api.manychat.com |
| Manus |
manus |
api.manus.ai |
| Microsoft Excel |
microsoft-excel |
graph.microsoft.com |
| Microsoft Teams |
microsoft-teams |
graph.microsoft.com |
| Microsoft To Do |
microsoft-to-do |
graph.microsoft.com |
| Monday.com |
monday |
api.monday.com |
| Motion |
motion |
api.usemotion.com |
| Netlify |
netlify |
api.netlify.com |
| Notion |
notion |
api.notion.com |
| Notion MCP |
notion |
mcp.notion.com |
| OneDrive |
one-drive |
graph.microsoft.com |
| Outlook |
outlook |
graph.microsoft.com |
| PDF.co |
pdf-co |
api.pdf.co |
| Pipedrive |
pipedrive |
api.pipedrive.com |
| Podio |
podio |
api.podio.com |
| PostHog |
posthog |
{subdomain}.posthog.com |
| QuickBooks |
quickbooks |
quickbooks.api.intuit.com |
| Quo |
quo |
api.openphone.com |
| Reducto |
reducto |
platform.reducto.ai |
| Salesforce |
salesforce |
{instance}.salesforce.com |
| Sentry |
sentry |
{subdomain}.sentry.io |
| SharePoint |
sharepoint |
graph.microsoft.com |
| SignNow |
signnow |
api.signnow.com |
| Slack |
slack |
slack.com |
| Snapchat |
snapchat |
adsapi.snapchat.com |
| Square |
squareup |
connect.squareup.com |
| Squarespace |
squarespace |
api.squarespace.com |
| Sunsama MCP |
sunsama |
MCP server |
| Stripe |
stripe |
api.stripe.com |
| Systeme.io |
systeme |
api.systeme.io |
| Tally |
tally |
api.tally.so |
| Tavily |
tavily |
api.tavily.com |
| Telegram |
telegram |
api.telegram.org |
| TickTick |
ticktick |
api.ticktick.com |
| Todoist |
todoist |
api.todoist.com |
| Toggl Track |
toggl-track |
api.track.toggl.com |
| Trello |
trello |
api.trello.com |
| Twilio |
twilio |
api.twilio.com |
| Typeform |
typeform |
api.typeform.com |
| Unbounce |
unbounce |
api.unbounce.com |
| Vimeo |
vimeo |
api.vimeo.com |
| WhatsApp Business |
whatsapp-business |
graph.facebook.com |
| WooCommerce |
woocommerce |
{store-url}/wp-json/wc/v3 |
| WordPress.com |
wordpress |
public-api.wordpress.com |
| Xero |
xero |
api.xero.com |
| YouTube |
youtube |
www.googleapis.com |
| Zoho Bigin |
zoho-bigin |
www.zohoapis.com |
| Zoho Bookings |
zoho-bookings |
www.zohoapis.com |
| Zoho Books |
zoho-books |
www.zohoapis.com |
| Zoho Calendar |
zoho-calendar |
calendar.zoho.com |
| Zoho CRM |
zoho-crm |
www.zohoapis.com |
| Zoho Inventory |
zoho-inventory |
www.zohoapis.com |
| Zoho Mail |
zoho-mail |
mail.zoho.com |
| Zoho People |
zoho-people |
people.zoho.com |
| Zoho Projects |
zoho-projects |
projectsapi.zoho.com |
| Zoho Recruit |
zoho-recruit |
recruit.zoho.com |
See references/ for detailed routing guides per provider:
- ActiveCampaign - Contacts, deals, tags, lists, automations, campaigns
- Acuity Scheduling - Appointments, calendars, clients, availability
- Airtable - Records, bases, tables
- Apollo - People search, enrichment, contacts
- Asana - Tasks, projects, workspaces, webhooks
- Attio - People, companies, records, tasks
- Basecamp - Projects, to-dos, messages, schedules, documents
- Baserow - Database rows, fields, tables, batch operations
- beehiiv - Publications, subscriptions, posts, custom fields
- Box - Files, folders, collaborations, shared links
- Brevo - Contacts, email campaigns, transactional emails, templates
- Calendly - Event types, scheduled events, availability, webhooks
- Cal.com - Event types, bookings, schedules, availability slots, webhooks
- CallRail - Calls, trackers, companies, tags, analytics
- Chargebee - Subscriptions, customers, invoices
- ClickFunnels - Contacts, products, orders, courses, webhooks
- ClickSend - SMS, MMS, voice messages, contacts, lists
- ClickUp - Tasks, lists, folders, spaces, webhooks
- Clockify - Time tracking, projects, clients, tasks, workspaces
- Coda - Docs, pages, tables, rows, formulas, controls
- Confluence - Pages, spaces, blogposts, comments, attachments
- CompanyCam - Projects, photos, users, tags, groups, documents
- Cognito Forms - Forms, entries, documents, files
- Constant Contact - Contacts, email campaigns, lists, segments
- Dropbox - Files, folders, search, metadata, revisions, tags
- Dropbox Business - Team members, groups, team folders, devices, audit logs
- ElevenLabs - Text-to-speech, voice cloning, sound effects, audio processing
- Eventbrite - Events, venues, tickets, orders, attendees
- Exa - Neural web search, content extraction, similar pages, AI answers, research tasks
- Fathom - Meeting recordings, transcripts, summaries, webhooks
- Firebase - Projects, web apps, Android apps, iOS apps, configurations
- Fireflies - Meeting transcripts, summaries, AskFred AI, channels
- GetResponse - Campaigns, contacts, newsletters, autoresponders, tags, segments
- Grafana - Dashboards, data sources, folders, annotations, alerts, teams
- GitHub - Repositories, issues, pull requests, commits
- Gumroad - Products, sales, subscribers, licenses, webhooks
- Granola MCP - MCP-based interface for meeting notes, transcripts, queries
- Google Ads - Campaigns, ad groups, GAQL queries
- Google Analytics Admin - Reports, dimensions, metrics
- Google Analytics Data - Reports, dimensions, metrics
- Google BigQuery - Datasets, tables, jobs, SQL queries
- Google Calendar - Events, calendars, free/busy
- Google Classroom - Courses, coursework, students, teachers, announcements
- Google Contacts - Contacts, contact groups, people search
- Google Docs - Document creation, batch updates
- Google Drive - Files, folders, permissions
- Google Forms - Forms, questions, responses
- Gmail - Messages, threads, labels
- Google Meet - Spaces, conference records, participants
- Google Merchant - Products, inventories, promotions, reports
- Google Play - In-app products, subscriptions, reviews
- Google Search Console - Search analytics, sitemaps
- Google Sheets - Values, ranges, formatting
- Google Slides - Presentations, slides, formatting
- Google Tasks - Task lists, tasks, subtasks
- Google Workspace Admin - Users, groups, org units, domains, roles
- HubSpot - Contacts, companies, deals
- Instantly - Campaigns, leads, accounts, email outreach
- Jira - Issues, projects, JQL queries
- Jobber - Clients, jobs, invoices, quotes (GraphQL)
- JotForm - Forms, submissions, webhooks
- Kaggle - Datasets, models, competitions, kernels
- Keap - Contacts, companies, tags, tasks, opportunities, campaigns
- Kibana - Saved objects, dashboards, data views, spaces, alerts, fleet
- Kit - Subscribers, tags, forms, sequences, broadcasts
- Klaviyo - Profiles, lists, campaigns, flows, events
- Lemlist - Campaigns, leads, activities, schedules, unsubscribes
- Linear - Issues, projects, teams, cycles (GraphQL)
- LinkedIn - Profile, posts, shares, media uploads
- Mailchimp - Audiences, campaigns, templates, automations
- MailerLite - Subscribers, groups, campaigns, automations, forms
- Mailgun - Email sending, domains, routes, templates, mailing lists, suppressions
- ManyChat - Subscribers, tags, flows, messaging
- Manus - AI agent tasks, projects, files, webhooks
- Microsoft Excel - Workbooks, worksheets, ranges, tables, charts
- Microsoft Teams - Teams, channels, messages, members, chats
- Microsoft To Do - Task lists, tasks, checklist items, linked resources
- Monday.com - Boards, items, columns, groups (GraphQL)
- Motion - Tasks, projects, workspaces, schedules
- Netlify - Sites, deploys, builds, DNS, environment variables
- Notion - Pages, databases, blocks
- Notion MCP - MCP-based interface for pages, databases, comments, teams, users
- OneDrive - Files, folders, drives, sharing
- Outlook - Mail, calendar, contacts
- PDF.co - PDF conversion, merge, split, edit, text extraction, barcodes
- Pipedrive - Deals, persons, organizations, activities
- Podio - Organizations, workspaces, apps, items, tasks, comments
- PostHog - Product analytics, feature flags, session recordings, experiments, HogQL queries
- QuickBooks - Customers, invoices, reports
- Quo - Calls, messages, contacts, conversations, webhooks
- Reducto - Document parsing, extraction, splitting, editing
- Salesforce - SOQL, sObjects, CRUD
- SignNow - Documents, templates, invites, e-signatures
- SendGrid - Email sending, contacts, templates, suppressions, statistics
- Sentry - Issues, events, projects, teams, releases
- SharePoint - Sites, lists, document libraries, files, folders, versions
- Slack - Messages, channels, users
- Snapchat - Ad accounts, campaigns, ad squads, ads, creatives, audiences
- Square - Payments, customers, orders, catalog, inventory, invoices
- Squarespace - Products, inventory, orders, profiles, transactions
- Sunsama MCP - MCP-based interface for tasks, calendar, backlog, objectives, time tracking
- Stripe - Customers, subscriptions, payments
- Systeme.io - Contacts, tags, courses, communities, webhooks
- Tally - Forms, submissions, workspaces, webhooks
- Tavily - AI web search, content extraction, crawling, research tasks
- Telegram - Messages, chats, bots, updates, polls
- TickTick - Tasks, projects, task lists
- Todoist - Tasks, projects, sections, labels, comments
- Toggl Track - Time entries, projects, clients, tags, workspaces
- Trello - Boards, lists, cards, checklists
- Twilio - SMS, voice calls, phone numbers, messaging
- Typeform - Forms, responses, insights
- Unbounce - Landing pages, leads, accounts, sub-accounts, domains
- Vimeo - Videos, folders, albums, comments, likes
- WhatsApp Business - Messages, templates, media
- WooCommerce - Products, orders, customers, coupons
- WordPress.com - Posts, pages, sites, users, settings
- Xero - Contacts, invoices, reports
- YouTube - Videos, playlists, channels, subscriptions
- Zoho Bigin - Contacts, companies, pipelines, products
- Zoho Bookings - Appointments, services, staff, workspaces
- Zoho Books - Invoices, contacts, bills, expenses
- Zoho Calendar - Calendars, events, attendees, reminders
- Zoho CRM - Leads, contacts, accounts, deals, search
- Zoho Inventory - Items, sales orders, invoices, purchase orders, bills
- Zoho Mail - Messages, folders, labels, attachments
- Zoho People - Employees, departments, designations, attendance, leave
- Zoho Projects - Projects, tasks, milestones, tasklists, comments
- Zoho Recruit - Candidates, job openings, interviews, applications
Examples
Slack - Post Message (Native API)
# Native Slack API: POST https://slack.com/api/chat.postMessage
python <<'EOF'
import urllib.request, os, json
data = json.dumps({'channel': 'C0123456', 'text': 'Hello!'}).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; charset=utf-8')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
HubSpot - Create Contact (Native API)
# Native HubSpot API: POST https://api.hubapi.com/crm/v3/objects/contacts
python <<'EOF'
import urllib.request, os, json
data = json.dumps({'properties': {'email': 'john@example.com', 'firstname': 'John', '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')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Google Sheets - Get Spreadsheet Values (Native API)
# Native Sheets API: GET https://sheets.googleapis.com/v4/spreadsheets/{id}/values/{range}
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/google-sheets/v4/spreadsheets/122BS1sFN2RKL8AOUQjkLdubzOwgqzPT64KfZ2rvYI4M/values/Sheet1!A1:B2')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Salesforce - SOQL Query (Native API)
# Native Salesforce API: GET https://{instance}.salesforce.com/services/data/v64.0/query?q=...
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/salesforce/services/data/v64.0/query?q=SELECT+Id,Name+FROM+Contact+LIMIT+10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Airtable - List Tables (Native API)
# Native Airtable API: GET https://api.airtable.com/v0/meta/bases/{id}/tables
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/airtable/v0/meta/bases/appgqan2NzWGP5sBK/tables')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Notion - Query Database (Native API)
# Native Notion API: POST https://api.notion.com/v1/data_sources/{id}/query
python <<'EOF'
import urllib.request, os, json
data = json.dumps({}).encode()
req = urllib.request.Request('https://gateway.maton.ai/notion/v1/data_sources/23702dc5-9a3b-8001-9e1c-000b5af0a980/query', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
req.add_header('Notion-Version', '2025-09-03')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Stripe - List Customers (Native API)
# Native Stripe API: GET https://api.stripe.com/v1/customers
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/stripe/v1/customers?limit=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Code Examples
JavaScript (Node.js)
const response = await fetch('https://gateway.maton.ai/slack/api/chat.postMessage', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${process.env.MATON_API_KEY}`
},
body: JSON.stringify({ channel: 'C0123456', text: 'Hello!' })
});
Python
import os
import requests
response = requests.post(
'https://gateway.maton.ai/slack/api/chat.postMessage',
headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'},
json={'channel': 'C0123456', 'text': 'Hello!'}
)
Error Handling
| Status |
Meaning |
| 400 |
Missing connection for the requested app |
| 401 |
Invalid or missing Maton API key |
| 429 |
Rate limited (10 requests/second per account) |
| 500 |
Internal Server Error |
| 4xx/5xx |
Passthrough error from the target API |
Errors from the target API are passed through with their original status codes and response bodies.
Troubleshooting: API Key Issues
- Check that the
MATON_API_KEY environment variable is set:
echo $MATON_API_KEY
- Verify the API key is valid by listing connections:
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Troubleshooting: Invalid App Name
- Verify your URL path starts with the correct app name. The path must begin with
/google-mail/. For example:
- Correct:
https://gateway.maton.ai/google-mail/gmail/v1/users/me/messages
- Incorrect:
https://gateway.maton.ai/gmail/v1/users/me/messages
- Ensure you have an active connection for the app. List your connections to verify:
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=google-mail&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Troubleshooting: Server Error
A 500 error may indicate an expired OAuth token. Try creating a new connection via the Connection Management section above and completing OAuth authorization. If the new connection is "ACTIVE", delete the old connection to ensure the gateway uses the new one.
Rate Limits
- 10 requests per second per account
- Target API rate limits also apply
Notes
- When using curl with URLs containing brackets (
fields[], sort[], records[]), use the -g flag to disable glob parsing
- When piping curl output to
jq, environment variables may not expand correctly in some shells, which can cause "Invalid API key" errors
Tips
Use native API docs: Refer to each service's official API documentation for endpoint paths and parameters.
Headers are forwarded: Custom headers (except Host and Authorization) are forwarded to the target API.
Query params work: URL query parameters are passed through to the target API.
All HTTP methods supported: GET, POST, PUT, PATCH, DELETE are all supported.
QuickBooks special case: Use :realmId in the path and it will be replaced with the connected realm ID.
Optional
1---2name: api-gateway3description: Passthrough proxy for direct access to third-party APIs using managed OAuth connections, provided by [Maton](https://maton.ai). The API gateway lets y4 Connect to 100+ APIs (Google Workspace, Microsoft 365, GitHub, Notion, Slack, Airtable, HubSpot, etc.) with managed OAuth.5 Use this skill when users want to interact with external services.6 Security: The MATON_API_KEY authenticates with Maton.ai but grants NO access to third-party services by itself. Each service requires explicit OAuth authorization by the user through Maton's connect flow. Access is strictly scoped to connections the user has authorized. Provided by Maton (https://maton.ai).7compatibility: Requires network access and valid Maton API key8metadata:9 source: https://skillmd.com/skills/aaaaqwq/api-gateway10 author: maton11 version: "1.0"12 clawdbot:13 emoji: 🧠14 homepage: "https://maton.ai"15 requires:16 env:17 - MATON_API_KEY18---1920# API Gateway2122Passthrough proxy for direct access to third-party APIs using managed OAuth connections, provided by [Maton](https://maton.ai). The API gateway lets you call native API endpoints directly.2324## Quick Start2526```bash27# Native Slack API call28python <<'EOF'29import urllib.request, os, json30data = json.dumps({'channel': 'C0123456', 'text': 'Hello from gateway!'}).encode()31req = urllib.request.Request('https://gateway.maton.ai/slack/api/chat.postMessage', data=data, method='POST')32req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')33req.add_header('Content-Type', 'application/json')34print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))35EOF36```373839## Base URL4041```42https://gateway.maton.ai/{app}/{native-api-path}43```4445Replace `{app}` with the service name and `{native-api-path}` with the actual API endpoint path.4647IMPORTANT: The URL path MUST start with the connection's app name (eg. `/google-mail/...`). This prefix tells the gateway which app connection to use. For example, the native Gmail API path starts with `gmail/v1/`, so full paths look like `/google-mail/gmail/v1/users/me/messages`.4849## Authentication5051All requests require the Maton API key in the Authorization header:5253```54Authorization: Bearer $MATON_API_KEY55```5657The API gateway automatically injects the appropriate OAuth token for the target service.5859**Environment Variable:** You can set your API key as the `MATON_API_KEY` environment variable:6061```bash62export MATON_API_KEY="YOUR_API_KEY"63```6465## Getting Your API Key66671. Sign in or create an account at [maton.ai](https://maton.ai)682. Go to [maton.ai/settings](https://maton.ai/settings)693. Click the copy button on the right side of API Key section to copy it7071## Connection Management7273Connection management uses a separate base URL: `https://ctrl.maton.ai`7475### List Connections7677```bash78python <<'EOF'79import urllib.request, os, json80req = urllib.request.Request('https://ctrl.maton.ai/connections?app=slack&status=ACTIVE')81req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')82print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))83EOF84```8586**Query Parameters (optional):**87- `app` - Filter by service name (e.g., `slack`, `hubspot`, `salesforce`)88- `status` - Filter by connection status (`ACTIVE`, `PENDING`, `FAILED`)8990**Response:**91```json92{93 "connections": [94 {95 "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80",96 "status": "ACTIVE",97 "creation_time": "2025-12-08T07:20:53.488460Z",98 "last_updated_time": "2026-01-31T20:03:32.593153Z",99 "url": "https://connect.maton.ai/?session_token=5e9...",100 "app": "slack",101 "method": "OAUTH2",102 "metadata": {}103 }104 ]105}106```107108### Create Connection109110```bash111python <<'EOF'112import urllib.request, os, json113data = json.dumps({'app': 'slack'}).encode()114req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')115req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')116req.add_header('Content-Type', 'application/json')117print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))118EOF119```120121**Request Body:**122- `app` (required) - Service name (e.g., `slack`, `notion`)123- `method` (optional) - Connection method (`API_KEY`, `BASIC`, `OAUTH1`, `OAUTH2`, `MCP`)124125### Get Connection126127```bash128python <<'EOF'129import urllib.request, os, json130req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')131req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')132print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))133EOF134```135136**Response:**137```json138{139 "connection": {140 "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80",141 "status": "ACTIVE",142 "creation_time": "2025-12-08T07:20:53.488460Z",143 "last_updated_time": "2026-01-31T20:03:32.593153Z",144 "url": "https://connect.maton.ai/?session_token=5e9...",145 "app": "slack",146 "metadata": {}147 }148}149```150151Open the returned URL in a browser to complete OAuth.152153### Delete Connection154155```bash156python <<'EOF'157import urllib.request, os, json158req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE')159req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')160print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))161EOF162```163164### Specifying Connection165166If you have multiple connections for the same app, you can specify which connection to use by adding the `Maton-Connection` header with the connection ID:167168```bash169python <<'EOF'170import urllib.request, os, json171data = json.dumps({'channel': 'C0123456', 'text': 'Hello!'}).encode()172req = urllib.request.Request('https://gateway.maton.ai/slack/api/chat.postMessage', data=data, method='POST')173req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')174req.add_header('Content-Type', 'application/json')175req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80')176print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))177EOF178```179180If omitted, the gateway uses the default (oldest) active connection for that app.181182## Supported Services183184| Service | App Name | Base URL Proxied |185|---------|----------|------------------|186| ActiveCampaign | `active-campaign` | `{account}.api-us1.com` |187| Acuity Scheduling | `acuity-scheduling` | `acuityscheduling.com` |188| Airtable | `airtable` | `api.airtable.com` |189| Apollo | `apollo` | `api.apollo.io` |190| Asana | `asana` | `app.asana.com` |191| Attio | `attio` | `api.attio.com` |192| Basecamp | `basecamp` | `3.basecampapi.com` |193| Baserow | `baserow` | `api.baserow.io` |194| beehiiv | `beehiiv` | `api.beehiiv.com` |195| Box | `box` | `api.box.com` |196| Brevo | `brevo` | `api.brevo.com` |197| Calendly | `calendly` | `api.calendly.com` |198| Cal.com | `cal-com` | `api.cal.com` |199| CallRail | `callrail` | `api.callrail.com` |200| Chargebee | `chargebee` | `{subdomain}.chargebee.com` |201| ClickFunnels | `clickfunnels` | `{subdomain}.myclickfunnels.com` |202| ClickSend | `clicksend` | `rest.clicksend.com` |203| ClickUp | `clickup` | `api.clickup.com` |204| Clockify | `clockify` | `api.clockify.me` |205| Coda | `coda` | `coda.io` |206| Confluence | `confluence` | `api.atlassian.com` |207| CompanyCam | `companycam` | `api.companycam.com` |208| Cognito Forms | `cognito-forms` | `www.cognitoforms.com` |209| Constant Contact | `constant-contact` | `api.cc.email` |210| Dropbox | `dropbox` | `api.dropboxapi.com` |211| Dropbox Business | `dropbox-business` | `api.dropboxapi.com` |212| ElevenLabs | `elevenlabs` | `api.elevenlabs.io` |213| Eventbrite | `eventbrite` | `www.eventbriteapi.com` |214| Exa | `exa` | `api.exa.ai` |215| Fathom | `fathom` | `api.fathom.ai` |216| Firebase | `firebase` | `firebase.googleapis.com` |217| Fireflies | `fireflies` | `api.fireflies.ai` |218| GetResponse | `getresponse` | `api.getresponse.com` |219| Grafana | `grafana` | User's Grafana instance |220| GitHub | `github` | `api.github.com` |221| Gumroad | `gumroad` | `api.gumroad.com` |222| Granola MCP | `granola` | `mcp.granola.ai` |223| Google Ads | `google-ads` | `googleads.googleapis.com` |224| Google BigQuery | `google-bigquery` | `bigquery.googleapis.com` |225| Google Analytics Admin | `google-analytics-admin` | `analyticsadmin.googleapis.com` |226| Google Analytics Data | `google-analytics-data` | `analyticsdata.googleapis.com` |227| Google Calendar | `google-calendar` | `www.googleapis.com` |228| Google Classroom | `google-classroom` | `classroom.googleapis.com` |229| Google Contacts | `google-contacts` | `people.googleapis.com` |230| Google Docs | `google-docs` | `docs.googleapis.com` |231| Google Drive | `google-drive` | `www.googleapis.com` |232| Google Forms | `google-forms` | `forms.googleapis.com` |233| Gmail | `google-mail` | `gmail.googleapis.com` |234| Google Merchant | `google-merchant` | `merchantapi.googleapis.com` |235| Google Meet | `google-meet` | `meet.googleapis.com` |236| Google Play | `google-play` | `androidpublisher.googleapis.com` |237| Google Search Console | `google-search-console` | `www.googleapis.com` |238| Google Sheets | `google-sheets` | `sheets.googleapis.com` |239| Google Slides | `google-slides` | `slides.googleapis.com` |240| Google Tasks | `google-tasks` | `tasks.googleapis.com` |241| Google Workspace Admin | `google-workspace-admin` | `admin.googleapis.com` |242| HubSpot | `hubspot` | `api.hubapi.com` |243| Instantly | `instantly` | `api.instantly.ai` |244| Jira | `jira` | `api.atlassian.com` |245| Jobber | `jobber` | `api.getjobber.com` |246| JotForm | `jotform` | `api.jotform.com` |247| Kaggle | `kaggle` | `api.kaggle.com` |248| Keap | `keap` | `api.infusionsoft.com` |249| Kibana | `kibana` | User's Kibana instance |250| Kit | `kit` | `api.kit.com` |251| Klaviyo | `klaviyo` | `a.klaviyo.com` |252| Lemlist | `lemlist` | `api.lemlist.com` |253| Linear | `linear` | `api.linear.app` |254| LinkedIn | `linkedin` | `api.linkedin.com` |255| Mailchimp | `mailchimp` | `{dc}.api.mailchimp.com` |256| MailerLite | `mailerlite` | `connect.mailerlite.com` |257| Mailgun | `mailgun` | `api.mailgun.net` |258| ManyChat | `manychat` | `api.manychat.com` |259| Manus | `manus` | `api.manus.ai` |260| Microsoft Excel | `microsoft-excel` | `graph.microsoft.com` |261| Microsoft Teams | `microsoft-teams` | `graph.microsoft.com` |262| Microsoft To Do | `microsoft-to-do` | `graph.microsoft.com` |263| Monday.com | `monday` | `api.monday.com` |264| Motion | `motion` | `api.usemotion.com` |265| Netlify | `netlify` | `api.netlify.com` |266| Notion | `notion` | `api.notion.com` |267| Notion MCP | `notion` | `mcp.notion.com` |268| OneDrive | `one-drive` | `graph.microsoft.com` |269| Outlook | `outlook` | `graph.microsoft.com` |270| PDF.co | `pdf-co` | `api.pdf.co` |271| Pipedrive | `pipedrive` | `api.pipedrive.com` |272| Podio | `podio` | `api.podio.com` |273| PostHog | `posthog` | `{subdomain}.posthog.com` |274| QuickBooks | `quickbooks` | `quickbooks.api.intuit.com` |275| Quo | `quo` | `api.openphone.com` |276| Reducto | `reducto` | `platform.reducto.ai` |277| Salesforce | `salesforce` | `{instance}.salesforce.com` |278| Sentry | `sentry` | `{subdomain}.sentry.io` |279| SharePoint | `sharepoint` | `graph.microsoft.com` |280| SignNow | `signnow` | `api.signnow.com` |281| Slack | `slack` | `slack.com` |282| Snapchat | `snapchat` | `adsapi.snapchat.com` |283| Square | `squareup` | `connect.squareup.com` |284| Squarespace | `squarespace` | `api.squarespace.com` |285| Sunsama MCP | `sunsama` | MCP server |286| Stripe | `stripe` | `api.stripe.com` |287| Systeme.io | `systeme` | `api.systeme.io` |288| Tally | `tally` | `api.tally.so` |289| Tavily | `tavily` | `api.tavily.com` |290| Telegram | `telegram` | `api.telegram.org` |291| TickTick | `ticktick` | `api.ticktick.com` |292| Todoist | `todoist` | `api.todoist.com` |293| Toggl Track | `toggl-track` | `api.track.toggl.com` |294| Trello | `trello` | `api.trello.com` |295| Twilio | `twilio` | `api.twilio.com` |296| Typeform | `typeform` | `api.typeform.com` |297| Unbounce | `unbounce` | `api.unbounce.com` |298| Vimeo | `vimeo` | `api.vimeo.com` |299| WhatsApp Business | `whatsapp-business` | `graph.facebook.com` |300| WooCommerce | `woocommerce` | `{store-url}/wp-json/wc/v3` |301| WordPress.com | `wordpress` | `public-api.wordpress.com` |302| Xero | `xero` | `api.xero.com` |303| YouTube | `youtube` | `www.googleapis.com` |304| Zoho Bigin | `zoho-bigin` | `www.zohoapis.com` |305| Zoho Bookings | `zoho-bookings` | `www.zohoapis.com` |306| Zoho Books | `zoho-books` | `www.zohoapis.com` |307| Zoho Calendar | `zoho-calendar` | `calendar.zoho.com` |308| Zoho CRM | `zoho-crm` | `www.zohoapis.com` |309| Zoho Inventory | `zoho-inventory` | `www.zohoapis.com` |310| Zoho Mail | `zoho-mail` | `mail.zoho.com` |311| Zoho People | `zoho-people` | `people.zoho.com` |312| Zoho Projects | `zoho-projects` | `projectsapi.zoho.com` |313| Zoho Recruit | `zoho-recruit` | `recruit.zoho.com` |314315See [references/](references/) for detailed routing guides per provider:316- [ActiveCampaign](references/active-campaign/README.md) - Contacts, deals, tags, lists, automations, campaigns317- [Acuity Scheduling](references/acuity-scheduling/README.md) - Appointments, calendars, clients, availability318- [Airtable](references/airtable/README.md) - Records, bases, tables319- [Apollo](references/apollo/README.md) - People search, enrichment, contacts320- [Asana](references/asana/README.md) - Tasks, projects, workspaces, webhooks321- [Attio](references/attio/README.md) - People, companies, records, tasks322- [Basecamp](references/basecamp/README.md) - Projects, to-dos, messages, schedules, documents323- [Baserow](references/baserow/README.md) - Database rows, fields, tables, batch operations324- [beehiiv](references/beehiiv/README.md) - Publications, subscriptions, posts, custom fields325- [Box](references/box/README.md) - Files, folders, collaborations, shared links326- [Brevo](references/brevo/README.md) - Contacts, email campaigns, transactional emails, templates327- [Calendly](references/calendly/README.md) - Event types, scheduled events, availability, webhooks328- [Cal.com](references/cal-com/README.md) - Event types, bookings, schedules, availability slots, webhooks329- [CallRail](references/callrail/README.md) - Calls, trackers, companies, tags, analytics330- [Chargebee](references/chargebee/README.md) - Subscriptions, customers, invoices331- [ClickFunnels](references/clickfunnels/README.md) - Contacts, products, orders, courses, webhooks332- [ClickSend](references/clicksend/README.md) - SMS, MMS, voice messages, contacts, lists333- [ClickUp](references/clickup/README.md) - Tasks, lists, folders, spaces, webhooks334- [Clockify](references/clockify/README.md) - Time tracking, projects, clients, tasks, workspaces335- [Coda](references/coda/README.md) - Docs, pages, tables, rows, formulas, controls336- [Confluence](references/confluence/README.md) - Pages, spaces, blogposts, comments, attachments337- [CompanyCam](references/companycam/README.md) - Projects, photos, users, tags, groups, documents338- [Cognito Forms](references/cognito-forms/README.md) - Forms, entries, documents, files339- [Constant Contact](references/constant-contact/README.md) - Contacts, email campaigns, lists, segments340- [Dropbox](references/dropbox/README.md) - Files, folders, search, metadata, revisions, tags341- [Dropbox Business](references/dropbox-business/README.md) - Team members, groups, team folders, devices, audit logs342- [ElevenLabs](references/elevenlabs/README.md) - Text-to-speech, voice cloning, sound effects, audio processing343- [Eventbrite](references/eventbrite/README.md) - Events, venues, tickets, orders, attendees344- [Exa](references/exa/README.md) - Neural web search, content extraction, similar pages, AI answers, research tasks345- [Fathom](references/fathom/README.md) - Meeting recordings, transcripts, summaries, webhooks346- [Firebase](references/firebase/README.md) - Projects, web apps, Android apps, iOS apps, configurations347- [Fireflies](references/fireflies/README.md) - Meeting transcripts, summaries, AskFred AI, channels348- [GetResponse](references/getresponse/README.md) - Campaigns, contacts, newsletters, autoresponders, tags, segments349- [Grafana](references/grafana/README.md) - Dashboards, data sources, folders, annotations, alerts, teams350- [GitHub](references/github/README.md) - Repositories, issues, pull requests, commits351- [Gumroad](references/gumroad/README.md) - Products, sales, subscribers, licenses, webhooks352- [Granola MCP](references/granola-mcp/README.md) - MCP-based interface for meeting notes, transcripts, queries353- [Google Ads](references/google-ads/README.md) - Campaigns, ad groups, GAQL queries354- [Google Analytics Admin](references/google-analytics-admin/README.md) - Reports, dimensions, metrics355- [Google Analytics Data](references/google-analytics-data/README.md) - Reports, dimensions, metrics356- [Google BigQuery](references/google-bigquery/README.md) - Datasets, tables, jobs, SQL queries357- [Google Calendar](references/google-calendar/README.md) - Events, calendars, free/busy358- [Google Classroom](references/google-classroom/README.md) - Courses, coursework, students, teachers, announcements359- [Google Contacts](references/google-contacts/README.md) - Contacts, contact groups, people search360- [Google Docs](references/google-docs/README.md) - Document creation, batch updates361- [Google Drive](references/google-drive/README.md) - Files, folders, permissions362- [Google Forms](references/google-forms/README.md) - Forms, questions, responses363- [Gmail](references/google-mail/README.md) - Messages, threads, labels364- [Google Meet](references/google-meet/README.md) - Spaces, conference records, participants365- [Google Merchant](references/google-merchant/README.md) - Products, inventories, promotions, reports366- [Google Play](references/google-play/README.md) - In-app products, subscriptions, reviews367- [Google Search Console](references/google-search-console/README.md) - Search analytics, sitemaps368- [Google Sheets](references/google-sheets/README.md) - Values, ranges, formatting369- [Google Slides](references/google-slides/README.md) - Presentations, slides, formatting370- [Google Tasks](references/google-tasks/README.md) - Task lists, tasks, subtasks371- [Google Workspace Admin](references/google-workspace-admin/README.md) - Users, groups, org units, domains, roles372- [HubSpot](references/hubspot/README.md) - Contacts, companies, deals373- [Instantly](references/instantly/README.md) - Campaigns, leads, accounts, email outreach374- [Jira](references/jira/README.md) - Issues, projects, JQL queries375- [Jobber](references/jobber/README.md) - Clients, jobs, invoices, quotes (GraphQL)376- [JotForm](references/jotform/README.md) - Forms, submissions, webhooks377- [Kaggle](references/kaggle/README.md) - Datasets, models, competitions, kernels378- [Keap](references/keap/README.md) - Contacts, companies, tags, tasks, opportunities, campaigns379- [Kibana](references/kibana/README.md) - Saved objects, dashboards, data views, spaces, alerts, fleet380- [Kit](references/kit/README.md) - Subscribers, tags, forms, sequences, broadcasts381- [Klaviyo](references/klaviyo/README.md) - Profiles, lists, campaigns, flows, events382- [Lemlist](references/lemlist/README.md) - Campaigns, leads, activities, schedules, unsubscribes383- [Linear](references/linear/README.md) - Issues, projects, teams, cycles (GraphQL)384- [LinkedIn](references/linkedin/README.md) - Profile, posts, shares, media uploads385- [Mailchimp](references/mailchimp/README.md) - Audiences, campaigns, templates, automations386- [MailerLite](references/mailerlite/README.md) - Subscribers, groups, campaigns, automations, forms387- [Mailgun](references/mailgun/README.md) - Email sending, domains, routes, templates, mailing lists, suppressions388- [ManyChat](references/manychat/README.md) - Subscribers, tags, flows, messaging389- [Manus](references/manus/README.md) - AI agent tasks, projects, files, webhooks390- [Microsoft Excel](references/microsoft-excel/README.md) - Workbooks, worksheets, ranges, tables, charts391- [Microsoft Teams](references/microsoft-teams/README.md) - Teams, channels, messages, members, chats392- [Microsoft To Do](references/microsoft-to-do/README.md) - Task lists, tasks, checklist items, linked resources393- [Monday.com](references/monday/README.md) - Boards, items, columns, groups (GraphQL)394- [Motion](references/motion/README.md) - Tasks, projects, workspaces, schedules395- [Netlify](references/netlify/README.md) - Sites, deploys, builds, DNS, environment variables396- [Notion](references/notion/README.md) - Pages, databases, blocks397- [Notion MCP](references/notion-mcp/README.md) - MCP-based interface for pages, databases, comments, teams, users398- [OneDrive](references/one-drive/README.md) - Files, folders, drives, sharing399- [Outlook](references/outlook/README.md) - Mail, calendar, contacts400- [PDF.co](references/pdf-co/README.md) - PDF conversion, merge, split, edit, text extraction, barcodes401- [Pipedrive](references/pipedrive/README.md) - Deals, persons, organizations, activities402- [Podio](references/podio/README.md) - Organizations, workspaces, apps, items, tasks, comments403- [PostHog](references/posthog/README.md) - Product analytics, feature flags, session recordings, experiments, HogQL queries404- [QuickBooks](references/quickbooks/README.md) - Customers, invoices, reports405- [Quo](references/quo/README.md) - Calls, messages, contacts, conversations, webhooks406- [Reducto](references/reducto/README.md) - Document parsing, extraction, splitting, editing407- [Salesforce](references/salesforce/README.md) - SOQL, sObjects, CRUD408- [SignNow](references/signnow/README.md) - Documents, templates, invites, e-signatures409- [SendGrid](references/sendgrid/README.md) - Email sending, contacts, templates, suppressions, statistics410- [Sentry](references/sentry/README.md) - Issues, events, projects, teams, releases411- [SharePoint](references/sharepoint/README.md) - Sites, lists, document libraries, files, folders, versions412- [Slack](references/slack/README.md) - Messages, channels, users413- [Snapchat](references/snapchat/README.md) - Ad accounts, campaigns, ad squads, ads, creatives, audiences414- [Square](references/squareup/README.md) - Payments, customers, orders, catalog, inventory, invoices415- [Squarespace](references/squarespace/README.md) - Products, inventory, orders, profiles, transactions416- [Sunsama MCP](references/sunsama-mcp/README.md) - MCP-based interface for tasks, calendar, backlog, objectives, time tracking417- [Stripe](references/stripe/README.md) - Customers, subscriptions, payments418- [Systeme.io](references/systeme/README.md) - Contacts, tags, courses, communities, webhooks419- [Tally](references/tally/README.md) - Forms, submissions, workspaces, webhooks420- [Tavily](references/tavily/README.md) - AI web search, content extraction, crawling, research tasks421- [Telegram](references/telegram/README.md) - Messages, chats, bots, updates, polls422- [TickTick](references/ticktick/README.md) - Tasks, projects, task lists423- [Todoist](references/todoist/README.md) - Tasks, projects, sections, labels, comments424- [Toggl Track](references/toggl-track/README.md) - Time entries, projects, clients, tags, workspaces425- [Trello](references/trello/README.md) - Boards, lists, cards, checklists426- [Twilio](references/twilio/README.md) - SMS, voice calls, phone numbers, messaging427- [Typeform](references/typeform/README.md) - Forms, responses, insights428- [Unbounce](references/unbounce/README.md) - Landing pages, leads, accounts, sub-accounts, domains429- [Vimeo](references/vimeo/README.md) - Videos, folders, albums, comments, likes430- [WhatsApp Business](references/whatsapp-business/README.md) - Messages, templates, media431- [WooCommerce](references/woocommerce/README.md) - Products, orders, customers, coupons432- [WordPress.com](references/wordpress/README.md) - Posts, pages, sites, users, settings433- [Xero](references/xero/README.md) - Contacts, invoices, reports434- [YouTube](references/youtube/README.md) - Videos, playlists, channels, subscriptions435- [Zoho Bigin](references/zoho-bigin/README.md) - Contacts, companies, pipelines, products436- [Zoho Bookings](references/zoho-bookings/README.md) - Appointments, services, staff, workspaces437- [Zoho Books](references/zoho-books/README.md) - Invoices, contacts, bills, expenses438- [Zoho Calendar](references/zoho-calendar/README.md) - Calendars, events, attendees, reminders439- [Zoho CRM](references/zoho-crm/README.md) - Leads, contacts, accounts, deals, search440- [Zoho Inventory](references/zoho-inventory/README.md) - Items, sales orders, invoices, purchase orders, bills441- [Zoho Mail](references/zoho-mail/README.md) - Messages, folders, labels, attachments442- [Zoho People](references/zoho-people/README.md) - Employees, departments, designations, attendance, leave443- [Zoho Projects](references/zoho-projects/README.md) - Projects, tasks, milestones, tasklists, comments444- [Zoho Recruit](references/zoho-recruit/README.md) - Candidates, job openings, interviews, applications445446## Examples447448### Slack - Post Message (Native API)449450```bash451# Native Slack API: POST https://slack.com/api/chat.postMessage452python <<'EOF'453import urllib.request, os, json454data = json.dumps({'channel': 'C0123456', 'text': 'Hello!'}).encode()455req = urllib.request.Request('https://gateway.maton.ai/slack/api/chat.postMessage', data=data, method='POST')456req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')457req.add_header('Content-Type', 'application/json; charset=utf-8')458print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))459EOF460```461462### HubSpot - Create Contact (Native API)463464```bash465# Native HubSpot API: POST https://api.hubapi.com/crm/v3/objects/contacts466python <<'EOF'467import urllib.request, os, json468data = json.dumps({'properties': {'email': 'john@example.com', 'firstname': 'John', 'lastname': 'Doe'}}).encode()469req = urllib.request.Request('https://gateway.maton.ai/hubspot/crm/v3/objects/contacts', data=data, method='POST')470req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')471req.add_header('Content-Type', 'application/json')472print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))473EOF474```475476### Google Sheets - Get Spreadsheet Values (Native API)477478```bash479# Native Sheets API: GET https://sheets.googleapis.com/v4/spreadsheets/{id}/values/{range}480python <<'EOF'481import urllib.request, os, json482req = urllib.request.Request('https://gateway.maton.ai/google-sheets/v4/spreadsheets/122BS1sFN2RKL8AOUQjkLdubzOwgqzPT64KfZ2rvYI4M/values/Sheet1!A1:B2')483req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')484print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))485EOF486```487488### Salesforce - SOQL Query (Native API)489490```bash491# Native Salesforce API: GET https://{instance}.salesforce.com/services/data/v64.0/query?q=...492python <<'EOF'493import urllib.request, os, json494req = urllib.request.Request('https://gateway.maton.ai/salesforce/services/data/v64.0/query?q=SELECT+Id,Name+FROM+Contact+LIMIT+10')495req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')496print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))497EOF498```499500### Airtable - List Tables (Native API)501502```bash503# Native Airtable API: GET https://api.airtable.com/v0/meta/bases/{id}/tables504python <<'EOF'505import urllib.request, os, json506req = urllib.request.Request('https://gateway.maton.ai/airtable/v0/meta/bases/appgqan2NzWGP5sBK/tables')507req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')508print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))509EOF510```511512### Notion - Query Database (Native API)513514```bash515# Native Notion API: POST https://api.notion.com/v1/data_sources/{id}/query516python <<'EOF'517import urllib.request, os, json518data = json.dumps({}).encode()519req = urllib.request.Request('https://gateway.maton.ai/notion/v1/data_sources/23702dc5-9a3b-8001-9e1c-000b5af0a980/query', data=data, method='POST')520req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')521req.add_header('Content-Type', 'application/json')522req.add_header('Notion-Version', '2025-09-03')523print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))524EOF525```526527### Stripe - List Customers (Native API)528529```bash530# Native Stripe API: GET https://api.stripe.com/v1/customers531python <<'EOF'532import urllib.request, os, json533req = urllib.request.Request('https://gateway.maton.ai/stripe/v1/customers?limit=10')534req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')535print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))536EOF537```538539## Code Examples540541### JavaScript (Node.js)542543```javascript544const response = await fetch('https://gateway.maton.ai/slack/api/chat.postMessage', {545 method: 'POST',546 headers: {547 'Content-Type': 'application/json',548 'Authorization': `Bearer ${process.env.MATON_API_KEY}`549 },550 body: JSON.stringify({ channel: 'C0123456', text: 'Hello!' })551});552```553554### Python555556```python557import os558import requests559560response = requests.post(561 'https://gateway.maton.ai/slack/api/chat.postMessage',562 headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'},563 json={'channel': 'C0123456', 'text': 'Hello!'}564)565```566567## Error Handling568569| Status | Meaning |570|--------|---------|571| 400 | Missing connection for the requested app |572| 401 | Invalid or missing Maton API key |573| 429 | Rate limited (10 requests/second per account) |574| 500 | Internal Server Error |575| 4xx/5xx | Passthrough error from the target API |576577Errors from the target API are passed through with their original status codes and response bodies.578579### Troubleshooting: API Key Issues5805811. Check that the `MATON_API_KEY` environment variable is set:582583```bash584echo $MATON_API_KEY585```5865872. Verify the API key is valid by listing connections:588589```bash590python <<'EOF'591import urllib.request, os, json592req = urllib.request.Request('https://ctrl.maton.ai/connections')593req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')594print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))595EOF596```597598### Troubleshooting: Invalid App Name5996001. Verify your URL path starts with the correct app name. The path must begin with `/google-mail/`. For example:601602- Correct: `https://gateway.maton.ai/google-mail/gmail/v1/users/me/messages`603- Incorrect: `https://gateway.maton.ai/gmail/v1/users/me/messages`6046052. Ensure you have an active connection for the app. List your connections to verify:606607```bash608python <<'EOF'609import urllib.request, os, json610req = urllib.request.Request('https://ctrl.maton.ai/connections?app=google-mail&status=ACTIVE')611req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')612print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))613EOF614```615616### Troubleshooting: Server Error617618A 500 error may indicate an expired OAuth token. Try creating a new connection via the Connection Management section above and completing OAuth authorization. If the new connection is "ACTIVE", delete the old connection to ensure the gateway uses the new one.619620## Rate Limits621622- 10 requests per second per account623- Target API rate limits also apply624625## Notes626627- When using curl with URLs containing brackets (`fields[]`, `sort[]`, `records[]`), use the `-g` flag to disable glob parsing628- When piping curl output to `jq`, environment variables may not expand correctly in some shells, which can cause "Invalid API key" errors629630## Tips6316321. **Use native API docs**: Refer to each service's official API documentation for endpoint paths and parameters.6336342. **Headers are forwarded**: Custom headers (except `Host` and `Authorization`) are forwarded to the target API.6356363. **Query params work**: URL query parameters are passed through to the target API.6376384. **All HTTP methods supported**: GET, POST, PUT, PATCH, DELETE are all supported.6396405. **QuickBooks special case**: Use `:realmId` in the path and it will be replaced with the connected realm ID.641642## Optional643644- [Github](https://github.com/maton-ai/api-gateway-skill)645- [API Reference](https://www.maton.ai/docs/api-reference)646- [Maton Community](https://discord.com/invite/dBfFAcefs2)647- [Maton Support](mailto:support@maton.ai)