Skip to main content Início Criadores bighardperson computer-science-skills-collection api-gateway
api-gateway Connect to 100+ APIs (Google Workspace, Microsoft 365, GitHub, Notion, Slack, Airtable, HubSpot, etc.) with managed OAuth.
Use this skill when users want to interact with external services.
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).
Ir para a instalação Skills Marketplace Descubra e explore skills de IA criadas pela comunidade.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Mostrar detalhes do prompt Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.
npx skills add https://github.com/bighardperson/computer-science-skills-collection --skill api-gatewayO comando permanece em uma só linha. Role horizontalmente para revisá-lo antes de copiar.
Prefere uma cópia local? Baixe os arquivos disponíveis atualmente no SkillsMP.
Baixar Zip Baixando... Ocupações relacionadas SOC
Baseado na classificação ocupacional SOC
Explorador de arquivos
100 arquivos name api-gateway description Connect to 100+ APIs (Google Workspace, Microsoft 365, GitHub, Notion, Slack, Airtable, HubSpot, etc.) with managed OAuth.
Use this skill when users want to interact with external services.
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).
description_zh 连接 100+ API 服务（Google、Microsoft、GitHub 等），通过 OAuth 管理授权 description_en Connect to 100+ APIs (Google, Microsoft, GitHub, etc.) with managed OAuth version 1.0.80 metadata {"author":"maton","version":"1.0","clawdbot":{"emoji":"🧠","homepage":"https://maton.ai","requires":{"env":["MATON_API_KEY"]}}} compatibility Requires network access and valid Maton API key
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
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" ,
"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
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
{
"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.comApify apifyapi.apify.comApollo apolloapi.apollo.ioAsana asanaapp.asana.comAttio attioapi.attio.comBasecamp basecamp3.basecampapi.comBaserow baserowapi.baserow.iobeehiiv beehiivapi.beehiiv.comBox boxapi.box.comBrevo brevoapi.brevo.comBrave Search brave-searchapi.search.brave.comBuffer bufferapi.buffer.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.comExa exaapi.exa.aifal.ai fal-aiqueue.fal.runFathom fathomapi.fathom.aiFirecrawl firecrawlapi.firecrawl.devFirebase firebasefirebase.googleapis.comFireflies firefliesapi.fireflies.aiFront frontapi2.frontapp.comGetResponse getresponseapi.getresponse.comGrafana grafanaUser's Grafana instance GitHub githubapi.github.comGumroad gumroadapi.gumroad.comGranola MCP granolamcp.granola.aiGoogle 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.comKaggle kaggleapi.kaggle.comKeap keapapi.infusionsoft.comKibana kibanaUser's Kibana instance Kit 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.netMake make{zone}.make.comManyChat manychatapi.manychat.comManus manusapi.manus.aiMemelord memelordwww.memelord.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.comNotion MCP notionmcp.notion.comOneNote one-notegraph.microsoft.comOneDrive one-drivegraph.microsoft.comOutlook outlookgraph.microsoft.comPDF.co pdf-coapi.pdf.coPipedrive pipedriveapi.pipedrive.comPodio podioapi.podio.comPostHog posthog{subdomain}.posthog.comQuickBooks quickbooksquickbooks.api.intuit.comQuo quoapi.openphone.comReducto reductoplatform.reducto.aiResend resendapi.resend.comSalesforce salesforce{instance}.salesforce.comSentry sentry{subdomain}.sentry.ioSharePoint sharepointgraph.microsoft.comSignNow signnowapi.signnow.comSlack slackslack.comSnapchat snapchatadsapi.snapchat.comSquare squareupconnect.squareup.comSquarespace squarespaceapi.squarespace.comStripe stripeapi.stripe.comSunsama MCP sunsamaMCP server Supabase supabase{project_ref}.supabase.coSysteme.io systemeapi.systeme.ioTally tallyapi.tally.soTavily tavilyapi.tavily.comTelegram telegramapi.telegram.orgTickTick ticktickapi.ticktick.comTodoist todoistapi.todoist.comToggl Track toggl-trackapi.track.toggl.comTrello trelloapi.trello.comTwilio twilioapi.twilio.comTwenty CRM twentyapi.twenty.comTypeform typeformapi.typeform.comUnbounce unbounceapi.unbounce.comVercel vercelapi.vercel.comVimeo vimeoapi.vimeo.comWATI wati{tenant}.wati.ioWhatsApp Business whatsapp-businessgraph.facebook.comWooCommerce woocommerce{store-url}/wp-json/wc/v3WordPress.com wordpresspublic-api.wordpress.comWrike wrikewww.wrike.comXero xeroapi.xero.comYouTube youtubewww.googleapis.comZoom zoomapi.zoom.usZoho 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 Projects zoho-projectsprojectsapi.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, tablesApify - Actors, runs, datasets, key-value stores, request queues, schedulesApollo - People search, enrichment, contactsAsana - Tasks, projects, workspaces, webhooksAttio - People, companies, records, tasksBasecamp - Projects, to-dos, messages, schedules, documentsBaserow - Database rows, fields, tables, batch operationsbeehiiv - Publications, subscriptions, posts, custom fieldsBox - Files, folders, collaborations, shared linksBrevo - Contacts, email campaigns, transactional emails, templatesBrave Search - Web search, image search, news search, video searchBuffer - Social media posts, channels, organizations, schedulingCalendly - 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, attendeesExa - Neural web search, content extraction, similar pages, AI answers, research tasksfal.ai - AI model inference (image generation, video, audio, upscaling)Fathom - Meeting recordings, transcripts, summaries, webhooksFirecrawl - Web scraping, crawling, site mapping, web searchFirebase - Projects, web apps, Android apps, iOS apps, configurationsFireflies - Meeting transcripts, summaries, AskFred AI, channelsFront - Conversations, messages, contacts, tags, inboxes, teammatesGetResponse - Campaigns, contacts, newsletters, autoresponders, tags, segmentsGrafana - Dashboards, data sources, folders, annotations, alerts, teamsGitHub - Repositories, issues, pull requests, commitsGumroad - Products, sales, subscribers, licenses, webhooksGranola MCP - MCP-based interface for meeting notes, transcripts, queriesGoogle 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, webhooksKaggle - Datasets, models, competitions, kernelsKeap - Contacts, companies, tags, tasks, opportunities, campaignsKibana - Saved objects, dashboards, data views, spaces, alerts, fleetKit - 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, suppressionsMake - Scenarios, organizations, teams, connections, data stores, hooksManyChat - Subscribers, tags, flows, messagingManus - AI agent tasks, projects, files, webhooksMemelord - AI meme generation, video memes, template editingMicrosoft 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, blocksNotion MCP - MCP-based interface for pages, databases, comments, teams, usersOneNote - Notebooks, sections, section groups, pages via Microsoft GraphOneDrive - 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, commentsPostHog - Product analytics, feature flags, session recordings, experiments, HogQL queriesQuickBooks - Customers, invoices, reportsQuo - Calls, messages, contacts, conversations, webhooksReducto - Document parsing, extraction, splitting, editingResend - Transactional emails, domains, audiences, contacts, broadcasts, webhooksSalesforce - SOQL, sObjects, CRUDSignNow - Documents, templates, invites, e-signaturesSendGrid - Email sending, contacts, templates, suppressions, statisticsSentry - Issues, events, projects, teams, releasesSharePoint - Sites, lists, document libraries, files, folders, versionsSlack - Messages, channels, usersSnapchat - Ad accounts, campaigns, ad squads, ads, creatives, audiencesSquare - Payments, customers, orders, catalog, inventory, invoicesSquarespace - Products, inventory, orders, profiles, transactionsStripe - Customers, subscriptions, paymentsSunsama MCP - MCP-based interface for tasks, calendar, backlog, objectives, time trackingSupabase - Database tables, auth users, storage bucketsSysteme.io - Contacts, tags, courses, communities, webhooksTally - Forms, submissions, workspaces, webhooksTavily - AI web search, content extraction, crawling, research tasksTelegram - 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, messagingTwenty CRM - Companies, people, opportunities, notes, tasksTypeform - Forms, responses, insightsUnbounce - Landing pages, leads, accounts, sub-accounts, domainsVercel - Projects, deployments, domains, environment variablesVimeo - Videos, folders, albums, comments, likesWATI - WhatsApp messages, contacts, templates, interactive messagesWhatsApp Business - Messages, templates, mediaWooCommerce - Products, orders, customers, couponsWordPress.com - Posts, pages, sites, users, settingsWrike - Tasks, folders, projects, spaces, comments, timelogs, workflowsXero - Contacts, invoices, reportsYouTube - Videos, playlists, channels, subscriptionsZoom - Meetings, recordings, webinars, usersZoho 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 Projects - Projects, tasks, milestones, tasklists, commentsZoho Recruit - Candidates, job openings, interviews, applications
Examples
Slack - Post Message (Native API)
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)
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)
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)
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)
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)
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)
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
Media upload URLs (LinkedIn, etc.): Some APIs return pre-signed upload URLs that point to a different host than the gateway proxies (e.g., LinkedIn returns www.linkedin.com upload URLs, but the gateway proxies api.linkedin.com). These upload URLs are pre-signed and do NOT require an Authorization header — upload the binary directly to the returned URL without going through the gateway. You MUST use Python urllib for these uploads because the URLs contain encoded characters (e.g., %253D) that get corrupted when passed through shell variables or curl. Always parse the JSON response with json.load() and use the URL directly in Python.
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 