Summary This source did not publish a separate summary. Review SKILL.md before using the skill.
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) {
"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",
"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
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
{
"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.comAcuity Scheduling acuity-schedulingacuityscheduling.comAirtable airtableapi.airtable.comApollo apolloapi.apollo.ioAsana asanaapp.asana.comAttio attioapi.attio.comBasecamp basecamp3.basecampapi.combeehiiv beehiivapi.beehiiv.comBox boxapi.box.comBrevo brevoapi.brevo.comCalendly calendlyapi.calendly.comCal.com cal-comapi.cal.comCallRail callrailapi.callrail.comChargebee chargebee{subdomain}.chargebee.comClickFunnels clickfunnels{subdomain}.myclickfunnels.comClickSend clicksendrest.clicksend.comClickUp clickupapi.clickup.comClockify clockifyapi.clockify.meCoda codacoda.ioConfluence confluenceapi.atlassian.comCompanyCam companycamapi.companycam.comCognito Forms cognito-formswww.cognitoforms.comConstant Contact constant-contactapi.cc.emailDropbox dropboxapi.dropboxapi.comDropbox Business dropbox-businessapi.dropboxapi.comElevenLabs elevenlabsapi.elevenlabs.ioEventbrite eventbritewww.eventbriteapi.comFathom fathomapi.fathom.aiFirebase firebasefirebase.googleapis.comFireflies firefliesapi.fireflies.aiGetResponse getresponseapi.getresponse.comGitHub githubapi.github.comGumroad gumroadapi.gumroad.comGoogle Ads google-adsgoogleads.googleapis.comGoogle BigQuery google-bigquerybigquery.googleapis.comGoogle Analytics Admin google-analytics-adminanalyticsadmin.googleapis.comGoogle Analytics Data google-analytics-dataanalyticsdata.googleapis.comGoogle Calendar google-calendarwww.googleapis.comGoogle Classroom google-classroomclassroom.googleapis.comGoogle Contacts google-contactspeople.googleapis.comGoogle Docs google-docsdocs.googleapis.comGoogle Drive google-drivewww.googleapis.comGoogle Forms google-formsforms.googleapis.comGmail google-mailgmail.googleapis.comGoogle Merchant google-merchantmerchantapi.googleapis.comGoogle Meet google-meetmeet.googleapis.comGoogle Play google-playandroidpublisher.googleapis.comGoogle Search Console google-search-consolewww.googleapis.comGoogle Sheets google-sheetssheets.googleapis.comGoogle Slides google-slidesslides.googleapis.comGoogle Tasks google-taskstasks.googleapis.comGoogle Workspace Admin google-workspace-adminadmin.googleapis.comHubSpot hubspotapi.hubapi.comInstantly instantlyapi.instantly.aiJira jiraapi.atlassian.comJobber jobberapi.getjobber.comJotForm jotformapi.jotform.comKeap keapapi.infusionsoft.comKit kitapi.kit.comKlaviyo klaviyoa.klaviyo.comLemlist lemlistapi.lemlist.comLinear linearapi.linear.appLinkedIn linkedinapi.linkedin.comMailchimp mailchimp{dc}.api.mailchimp.comMailerLite mailerliteconnect.mailerlite.comMailgun mailgunapi.mailgun.netManyChat manychatapi.manychat.comMicrosoft Excel microsoft-excelgraph.microsoft.comMicrosoft Teams microsoft-teamsgraph.microsoft.comMicrosoft To Do microsoft-to-dograph.microsoft.comMonday.com mondayapi.monday.comMotion motionapi.usemotion.comNetlify netlifyapi.netlify.comNotion notionapi.notion.comOneDrive one-drivegraph.microsoft.comOutlook outlookgraph.microsoft.comPDF.co pdf-coapi.pdf.coPipedrive pipedriveapi.pipedrive.comPodio podioapi.podio.comQuickBooks quickbooksquickbooks.api.intuit.comQuo quoapi.openphone.comSalesforce salesforce{instance}.salesforce.comSignNow signnowapi.signnow.comSlack slackslack.comSnapchat snapchatadsapi.snapchat.comSquare squareupconnect.squareup.comStripe stripeapi.stripe.comSysteme.io systemeapi.systeme.ioTally tallyapi.tally.soTelegram telegramapi.telegram.orgTickTick ticktickapi.ticktick.comTodoist todoistapi.todoist.comToggl Track toggl-trackapi.track.toggl.comTrello trelloapi.trello.comTwilio twilioapi.twilio.comTypeform typeformapi.typeform.comVimeo vimeoapi.vimeo.comWhatsApp Business whatsapp-businessgraph.facebook.comWooCommerce woocommerce{store-url}/wp-json/wc/v3WordPress.com wordpresspublic-api.wordpress.comXero xeroapi.xero.comYouTube youtubewww.googleapis.comZoho Bigin zoho-biginwww.zohoapis.comZoho Bookings zoho-bookingswww.zohoapis.comZoho Books zoho-bookswww.zohoapis.comZoho Calendar zoho-calendarcalendar.zoho.comZoho CRM zoho-crmwww.zohoapis.comZoho Inventory zoho-inventorywww.zohoapis.comZoho Mail zoho-mailmail.zoho.comZoho People zoho-peoplepeople.zoho.comZoho Recruit zoho-recruitrecruit.zoho.com
See references/ for detailed routing guides per provider:
ActiveCampaign - Contacts, deals, tags, lists, automations, campaignsAcuity Scheduling - Appointments, calendars, clients, availabilityAirtable - Records, bases, tablesApollo - People search, enrichment, contactsAsana - Tasks, projects, workspaces, webhooksAttio - People, companies, records, tasksBasecamp - Projects, to-dos, messages, schedules, documentsbeehiiv - Publications, subscriptions, posts, custom fieldsBox - Files, folders, collaborations, shared linksBrevo - Contacts, email campaigns, transactional emails, templatesCalendly - Event types, scheduled events, availability, webhooksCal.com - Event types, bookings, schedules, availability slots, webhooksCallRail - Calls, trackers, companies, tags, analyticsChargebee - Subscriptions, customers, invoicesClickFunnels - Contacts, products, orders, courses, webhooksClickSend - SMS, MMS, voice messages, contacts, listsClickUp - Tasks, lists, folders, spaces, webhooksClockify - Time tracking, projects, clients, tasks, workspacesCoda - Docs, pages, tables, rows, formulas, controlsConfluence - Pages, spaces, blogposts, comments, attachmentsCompanyCam - Projects, photos, users, tags, groups, documentsCognito Forms - Forms, entries, documents, filesConstant Contact - Contacts, email campaigns, lists, segmentsDropbox - Files, folders, search, metadata, revisions, tagsDropbox Business - Team members, groups, team folders, devices, audit logsElevenLabs - Text-to-speech, voice cloning, sound effects, audio processingEventbrite - Events, venues, tickets, orders, attendeesFathom - Meeting recordings, transcripts, summaries, webhooksFirebase - Projects, web apps, Android apps, iOS apps, configurationsFireflies - Meeting transcripts, summaries, AskFred AI, channelsGetResponse - Campaigns, contacts, newsletters, autoresponders, tags, segmentsGitHub - Repositories, issues, pull requests, commitsGumroad - Products, sales, subscribers, licenses, webhooksGoogle Ads - Campaigns, ad groups, GAQL queriesGoogle Analytics Admin - Reports, dimensions, metricsGoogle Analytics Data - Reports, dimensions, metricsGoogle BigQuery - Datasets, tables, jobs, SQL queriesGoogle Calendar - Events, calendars, free/busyGoogle Classroom - Courses, coursework, students, teachers, announcementsGoogle Contacts - Contacts, contact groups, people searchGoogle Docs - Document creation, batch updatesGoogle Drive - Files, folders, permissionsGoogle Forms - Forms, questions, responsesGmail - Messages, threads, labelsGoogle Meet - Spaces, conference records, participantsGoogle Merchant - Products, inventories, promotions, reportsGoogle Play - In-app products, subscriptions, reviewsGoogle Search Console - Search analytics, sitemapsGoogle Sheets - Values, ranges, formattingGoogle Slides - Presentations, slides, formattingGoogle Tasks - Task lists, tasks, subtasksGoogle Workspace Admin - Users, groups, org units, domains, rolesHubSpot - Contacts, companies, dealsInstantly - Campaigns, leads, accounts, email outreachJira - Issues, projects, JQL queriesJobber - Clients, jobs, invoices, quotes (GraphQL)JotForm - Forms, submissions, webhooksKeap - Contacts, companies, tags, tasks, opportunities, campaignsKit - Subscribers, tags, forms, sequences, broadcastsKlaviyo - Profiles, lists, campaigns, flows, eventsLemlist - Campaigns, leads, activities, schedules, unsubscribesLinear - Issues, projects, teams, cycles (GraphQL)LinkedIn - Profile, posts, shares, media uploadsMailchimp - Audiences, campaigns, templates, automationsMailerLite - Subscribers, groups, campaigns, automations, formsMailgun - Email sending, domains, routes, templates, mailing lists, suppressionsManyChat - Subscribers, tags, flows, messagingMicrosoft Excel - Workbooks, worksheets, ranges, tables, chartsMicrosoft Teams - Teams, channels, messages, members, chatsMicrosoft To Do - Task lists, tasks, checklist items, linked resourcesMonday.com - Boards, items, columns, groups (GraphQL)Motion - Tasks, projects, workspaces, schedulesNetlify - Sites, deploys, builds, DNS, environment variablesNotion - Pages, databases, blocksOneDrive - Files, folders, drives, sharingOutlook - Mail, calendar, contactsPDF.co - PDF conversion, merge, split, edit, text extraction, barcodesPipedrive - Deals, persons, organizations, activitiesPodio - Organizations, workspaces, apps, items, tasks, commentsQuickBooks - Customers, invoices, reportsQuo - Calls, messages, contacts, conversations, webhooksSalesforce - SOQL, sObjects, CRUDSignNow - Documents, templates, invites, e-signaturesSendGrid - Email sending, contacts, templates, suppressions, statisticsSlack - Messages, channels, usersSnapchat - Ad accounts, campaigns, ad squads, ads, creatives, audiencesSquare - Payments, customers, orders, catalog, inventory, invoicesStripe - Customers, subscriptions, paymentsSysteme.io - Contacts, tags, courses, communities, webhooksTally - Forms, submissions, workspaces, webhooksTelegram - Messages, chats, bots, updates, pollsTickTick - Tasks, projects, task listsTodoist - Tasks, projects, sections, labels, commentsToggl Track - Time entries, projects, clients, tags, workspacesTrello - Boards, lists, cards, checklistsTwilio - SMS, voice calls, phone numbers, messagingTypeform - Forms, responses, insightsVimeo - Videos, folders, albums, comments, likesWhatsApp Business - Messages, templates, mediaWooCommerce - Products, orders, customers, couponsWordPress.com - Posts, pages, sites, users, settingsXero - Contacts, invoices, reportsYouTube - Videos, playlists, channels, subscriptionsZoho Bigin - Contacts, companies, pipelines, productsZoho Bookings - Appointments, services, staff, workspacesZoho Books - Invoices, contacts, bills, expensesZoho Calendar - Calendars, events, attendees, remindersZoho CRM - Leads, contacts, accounts, deals, searchZoho Inventory - Items, sales orders, invoices, purchase orders, billsZoho Mail - Messages, folders, labels, attachmentsZoho People - Employees, departments, designations, attendance, leaveZoho 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': '[email protected] ', '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:
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 