{
  "schemaVersion": "1.0",
  "item": {
    "slug": "api-gateway-1",
    "name": "Api Gateway 1",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/kdegeek/api-gateway-1",
    "canonicalUrl": "https://clawhub.ai/kdegeek/api-gateway-1",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/api-gateway-1",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=api-gateway-1",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "LICENSE.txt",
      "SKILL.md",
      "_meta.json",
      "references/active-campaign.md",
      "references/acuity-scheduling.md",
      "references/airtable.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/api-gateway-1"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/api-gateway-1",
    "agentPageUrl": "https://openagent3.xyz/skills/api-gateway-1/agent",
    "manifestUrl": "https://openagent3.xyz/skills/api-gateway-1/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/api-gateway-1/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "API Gateway",
        "body": "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."
      },
      {
        "title": "Quick Start",
        "body": "# Native Slack API call\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'channel': 'C0123456', 'text': 'Hello from gateway!'}).encode()\nreq = urllib.request.Request('https://gateway.maton.ai/slack/api/chat.postMessage', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF"
      },
      {
        "title": "Base URL",
        "body": "https://gateway.maton.ai/{app}/{native-api-path}\n\nReplace {app} with the service name and {native-api-path} with the actual API endpoint path.\n\nIMPORTANT: 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."
      },
      {
        "title": "Authentication",
        "body": "All requests require the Maton API key in the Authorization header:\n\nAuthorization: Bearer $MATON_API_KEY\n\nThe API gateway automatically injects the appropriate OAuth token for the target service.\n\nEnvironment Variable: You can set your API key as the MATON_API_KEY environment variable:\n\nexport MATON_API_KEY=\"YOUR_API_KEY\""
      },
      {
        "title": "Getting Your API Key",
        "body": "Sign in or create an account at maton.ai\nGo to maton.ai/settings\nClick the copy button on the right side of API Key section to copy it"
      },
      {
        "title": "Connection Management",
        "body": "Connection management uses a separate base URL: https://ctrl.maton.ai"
      },
      {
        "title": "List Connections",
        "body": "python <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://ctrl.maton.ai/connections?app=slack&status=ACTIVE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nQuery Parameters (optional):\n\napp - Filter by service name (e.g., slack, hubspot, salesforce)\nstatus - Filter by connection status (ACTIVE, PENDING, FAILED)\n\nResponse:\n\n{\n  \"connections\": [\n    {\n      \"connection_id\": \"21fd90f9-5935-43cd-b6c8-bde9d915ca80\",\n      \"status\": \"ACTIVE\",\n      \"creation_time\": \"2025-12-08T07:20:53.488460Z\",\n      \"last_updated_time\": \"2026-01-31T20:03:32.593153Z\",\n      \"url\": \"https://connect.maton.ai/?session_token=5e9...\",\n      \"app\": \"slack\",\n      \"metadata\": {}\n    }\n  ]\n}"
      },
      {
        "title": "Create Connection",
        "body": "python <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'app': 'slack'}).encode()\nreq = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF"
      },
      {
        "title": "Get Connection",
        "body": "python <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nResponse:\n\n{\n  \"connection\": {\n    \"connection_id\": \"21fd90f9-5935-43cd-b6c8-bde9d915ca80\",\n    \"status\": \"ACTIVE\",\n    \"creation_time\": \"2025-12-08T07:20:53.488460Z\",\n    \"last_updated_time\": \"2026-01-31T20:03:32.593153Z\",\n    \"url\": \"https://connect.maton.ai/?session_token=5e9...\",\n    \"app\": \"slack\",\n    \"metadata\": {}\n  }\n}\n\nOpen the returned URL in a browser to complete OAuth."
      },
      {
        "title": "Delete Connection",
        "body": "python <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF"
      },
      {
        "title": "Specifying Connection",
        "body": "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:\n\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'channel': 'C0123456', 'text': 'Hello!'}).encode()\nreq = urllib.request.Request('https://gateway.maton.ai/slack/api/chat.postMessage', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json')\nreq.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nIf omitted, the gateway uses the default (oldest) active connection for that app."
      },
      {
        "title": "Supported Services",
        "body": "ServiceApp NameBase URL ProxiedActiveCampaignactive-campaign{account}.api-us1.comAcuity Schedulingacuity-schedulingacuityscheduling.comAirtableairtableapi.airtable.comApolloapolloapi.apollo.ioAsanaasanaapp.asana.comAttioattioapi.attio.comBasecampbasecamp3.basecampapi.combeehiivbeehiivapi.beehiiv.comBoxboxapi.box.comBrevobrevoapi.brevo.comCalendlycalendlyapi.calendly.comCal.comcal-comapi.cal.comCallRailcallrailapi.callrail.comChargebeechargebee{subdomain}.chargebee.comClickFunnelsclickfunnels{subdomain}.myclickfunnels.comClickSendclicksendrest.clicksend.comClickUpclickupapi.clickup.comClockifyclockifyapi.clockify.meCodacodacoda.ioConfluenceconfluenceapi.atlassian.comCompanyCamcompanycamapi.companycam.comCognito Formscognito-formswww.cognitoforms.comConstant Contactconstant-contactapi.cc.emailDropboxdropboxapi.dropboxapi.comDropbox Businessdropbox-businessapi.dropboxapi.comElevenLabselevenlabsapi.elevenlabs.ioEventbriteeventbritewww.eventbriteapi.comFathomfathomapi.fathom.aiFirebasefirebasefirebase.googleapis.comFirefliesfirefliesapi.fireflies.aiGetResponsegetresponseapi.getresponse.comGitHubgithubapi.github.comGumroadgumroadapi.gumroad.comGoogle Adsgoogle-adsgoogleads.googleapis.comGoogle BigQuerygoogle-bigquerybigquery.googleapis.comGoogle Analytics Admingoogle-analytics-adminanalyticsadmin.googleapis.comGoogle Analytics Datagoogle-analytics-dataanalyticsdata.googleapis.comGoogle Calendargoogle-calendarwww.googleapis.comGoogle Classroomgoogle-classroomclassroom.googleapis.comGoogle Contactsgoogle-contactspeople.googleapis.comGoogle Docsgoogle-docsdocs.googleapis.comGoogle Drivegoogle-drivewww.googleapis.comGoogle Formsgoogle-formsforms.googleapis.comGmailgoogle-mailgmail.googleapis.comGoogle Merchantgoogle-merchantmerchantapi.googleapis.comGoogle Meetgoogle-meetmeet.googleapis.comGoogle Playgoogle-playandroidpublisher.googleapis.comGoogle Search Consolegoogle-search-consolewww.googleapis.comGoogle Sheetsgoogle-sheetssheets.googleapis.comGoogle Slidesgoogle-slidesslides.googleapis.comGoogle Tasksgoogle-taskstasks.googleapis.comGoogle Workspace Admingoogle-workspace-adminadmin.googleapis.comHubSpothubspotapi.hubapi.comInstantlyinstantlyapi.instantly.aiJirajiraapi.atlassian.comJobberjobberapi.getjobber.comJotFormjotformapi.jotform.comKeapkeapapi.infusionsoft.comKitkitapi.kit.comKlaviyoklaviyoa.klaviyo.comLemlistlemlistapi.lemlist.comLinearlinearapi.linear.appLinkedInlinkedinapi.linkedin.comMailchimpmailchimp{dc}.api.mailchimp.comMailerLitemailerliteconnect.mailerlite.comMailgunmailgunapi.mailgun.netManyChatmanychatapi.manychat.comMicrosoft Excelmicrosoft-excelgraph.microsoft.comMicrosoft Teamsmicrosoft-teamsgraph.microsoft.comMicrosoft To Domicrosoft-to-dograph.microsoft.comMonday.commondayapi.monday.comMotionmotionapi.usemotion.comNetlifynetlifyapi.netlify.comNotionnotionapi.notion.comOneDriveone-drivegraph.microsoft.comOutlookoutlookgraph.microsoft.comPDF.copdf-coapi.pdf.coPipedrivepipedriveapi.pipedrive.comPodiopodioapi.podio.comQuickBooksquickbooksquickbooks.api.intuit.comQuoquoapi.openphone.comSalesforcesalesforce{instance}.salesforce.comSignNowsignnowapi.signnow.comSlackslackslack.comSnapchatsnapchatadsapi.snapchat.comSquaresquareupconnect.squareup.comStripestripeapi.stripe.comSysteme.iosystemeapi.systeme.ioTallytallyapi.tally.soTelegramtelegramapi.telegram.orgTickTickticktickapi.ticktick.comTodoisttodoistapi.todoist.comToggl Tracktoggl-trackapi.track.toggl.comTrellotrelloapi.trello.comTwiliotwilioapi.twilio.comTypeformtypeformapi.typeform.comVimeovimeoapi.vimeo.comWhatsApp Businesswhatsapp-businessgraph.facebook.comWooCommercewoocommerce{store-url}/wp-json/wc/v3WordPress.comwordpresspublic-api.wordpress.comXeroxeroapi.xero.comYouTubeyoutubewww.googleapis.comZoho Biginzoho-biginwww.zohoapis.comZoho Bookingszoho-bookingswww.zohoapis.comZoho Bookszoho-bookswww.zohoapis.comZoho Calendarzoho-calendarcalendar.zoho.comZoho CRMzoho-crmwww.zohoapis.comZoho Inventoryzoho-inventorywww.zohoapis.comZoho Mailzoho-mailmail.zoho.comZoho Peoplezoho-peoplepeople.zoho.comZoho Recruitzoho-recruitrecruit.zoho.com\n\nSee references/ for detailed routing guides per provider:\n\nActiveCampaign - Contacts, deals, tags, lists, automations, campaigns\nAcuity Scheduling - Appointments, calendars, clients, availability\nAirtable - Records, bases, tables\nApollo - People search, enrichment, contacts\nAsana - Tasks, projects, workspaces, webhooks\nAttio - People, companies, records, tasks\nBasecamp - Projects, to-dos, messages, schedules, documents\nbeehiiv - Publications, subscriptions, posts, custom fields\nBox - Files, folders, collaborations, shared links\nBrevo - Contacts, email campaigns, transactional emails, templates\nCalendly - Event types, scheduled events, availability, webhooks\nCal.com - Event types, bookings, schedules, availability slots, webhooks\nCallRail - Calls, trackers, companies, tags, analytics\nChargebee - Subscriptions, customers, invoices\nClickFunnels - Contacts, products, orders, courses, webhooks\nClickSend - SMS, MMS, voice messages, contacts, lists\nClickUp - Tasks, lists, folders, spaces, webhooks\nClockify - Time tracking, projects, clients, tasks, workspaces\nCoda - Docs, pages, tables, rows, formulas, controls\nConfluence - Pages, spaces, blogposts, comments, attachments\nCompanyCam - Projects, photos, users, tags, groups, documents\nCognito Forms - Forms, entries, documents, files\nConstant Contact - Contacts, email campaigns, lists, segments\nDropbox - Files, folders, search, metadata, revisions, tags\nDropbox Business - Team members, groups, team folders, devices, audit logs\nElevenLabs - Text-to-speech, voice cloning, sound effects, audio processing\nEventbrite - Events, venues, tickets, orders, attendees\nFathom - Meeting recordings, transcripts, summaries, webhooks\nFirebase - Projects, web apps, Android apps, iOS apps, configurations\nFireflies - Meeting transcripts, summaries, AskFred AI, channels\nGetResponse - Campaigns, contacts, newsletters, autoresponders, tags, segments\nGitHub - Repositories, issues, pull requests, commits\nGumroad - Products, sales, subscribers, licenses, webhooks\nGoogle Ads - Campaigns, ad groups, GAQL queries\nGoogle Analytics Admin - Reports, dimensions, metrics\nGoogle Analytics Data - Reports, dimensions, metrics\nGoogle BigQuery - Datasets, tables, jobs, SQL queries\nGoogle Calendar - Events, calendars, free/busy\nGoogle Classroom - Courses, coursework, students, teachers, announcements\nGoogle Contacts - Contacts, contact groups, people search\nGoogle Docs - Document creation, batch updates\nGoogle Drive - Files, folders, permissions\nGoogle Forms - Forms, questions, responses\nGmail - Messages, threads, labels\nGoogle Meet - Spaces, conference records, participants\nGoogle Merchant - Products, inventories, promotions, reports\nGoogle Play - In-app products, subscriptions, reviews\nGoogle Search Console - Search analytics, sitemaps\nGoogle Sheets - Values, ranges, formatting\nGoogle Slides - Presentations, slides, formatting\nGoogle Tasks - Task lists, tasks, subtasks\nGoogle Workspace Admin - Users, groups, org units, domains, roles\nHubSpot - Contacts, companies, deals\nInstantly - Campaigns, leads, accounts, email outreach\nJira - Issues, projects, JQL queries\nJobber - Clients, jobs, invoices, quotes (GraphQL)\nJotForm - Forms, submissions, webhooks\nKeap - Contacts, companies, tags, tasks, opportunities, campaigns\nKit - Subscribers, tags, forms, sequences, broadcasts\nKlaviyo - Profiles, lists, campaigns, flows, events\nLemlist - Campaigns, leads, activities, schedules, unsubscribes\nLinear - Issues, projects, teams, cycles (GraphQL)\nLinkedIn - Profile, posts, shares, media uploads\nMailchimp - Audiences, campaigns, templates, automations\nMailerLite - Subscribers, groups, campaigns, automations, forms\nMailgun - Email sending, domains, routes, templates, mailing lists, suppressions\nManyChat - Subscribers, tags, flows, messaging\nMicrosoft Excel - Workbooks, worksheets, ranges, tables, charts\nMicrosoft Teams - Teams, channels, messages, members, chats\nMicrosoft To Do - Task lists, tasks, checklist items, linked resources\nMonday.com - Boards, items, columns, groups (GraphQL)\nMotion - Tasks, projects, workspaces, schedules\nNetlify - Sites, deploys, builds, DNS, environment variables\nNotion - Pages, databases, blocks\nOneDrive - Files, folders, drives, sharing\nOutlook - Mail, calendar, contacts\nPDF.co - PDF conversion, merge, split, edit, text extraction, barcodes\nPipedrive - Deals, persons, organizations, activities\nPodio - Organizations, workspaces, apps, items, tasks, comments\nQuickBooks - Customers, invoices, reports\nQuo - Calls, messages, contacts, conversations, webhooks\nSalesforce - SOQL, sObjects, CRUD\nSignNow - Documents, templates, invites, e-signatures\nSendGrid - Email sending, contacts, templates, suppressions, statistics\nSlack - Messages, channels, users\nSnapchat - Ad accounts, campaigns, ad squads, ads, creatives, audiences\nSquare - Payments, customers, orders, catalog, inventory, invoices\nStripe - Customers, subscriptions, payments\nSysteme.io - Contacts, tags, courses, communities, webhooks\nTally - Forms, submissions, workspaces, webhooks\nTelegram - Messages, chats, bots, updates, polls\nTickTick - Tasks, projects, task lists\nTodoist - Tasks, projects, sections, labels, comments\nToggl Track - Time entries, projects, clients, tags, workspaces\nTrello - Boards, lists, cards, checklists\nTwilio - SMS, voice calls, phone numbers, messaging\nTypeform - Forms, responses, insights\nVimeo - Videos, folders, albums, comments, likes\nWhatsApp Business - Messages, templates, media\nWooCommerce - Products, orders, customers, coupons\nWordPress.com - Posts, pages, sites, users, settings\nXero - Contacts, invoices, reports\nYouTube - Videos, playlists, channels, subscriptions\nZoho Bigin - Contacts, companies, pipelines, products\nZoho Bookings - Appointments, services, staff, workspaces\nZoho Books - Invoices, contacts, bills, expenses\nZoho Calendar - Calendars, events, attendees, reminders\nZoho CRM - Leads, contacts, accounts, deals, search\nZoho Inventory - Items, sales orders, invoices, purchase orders, bills\nZoho Mail - Messages, folders, labels, attachments\nZoho People - Employees, departments, designations, attendance, leave\nZoho Recruit - Candidates, job openings, interviews, applications"
      },
      {
        "title": "Slack - Post Message (Native API)",
        "body": "# Native Slack API: POST https://slack.com/api/chat.postMessage\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'channel': 'C0123456', 'text': 'Hello!'}).encode()\nreq = urllib.request.Request('https://gateway.maton.ai/slack/api/chat.postMessage', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json; charset=utf-8')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF"
      },
      {
        "title": "HubSpot - Create Contact (Native API)",
        "body": "# Native HubSpot API: POST https://api.hubapi.com/crm/v3/objects/contacts\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'properties': {'email': 'john@example.com', 'firstname': 'John', 'lastname': 'Doe'}}).encode()\nreq = urllib.request.Request('https://gateway.maton.ai/hubspot/crm/v3/objects/contacts', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF"
      },
      {
        "title": "Google Sheets - Get Spreadsheet Values (Native API)",
        "body": "# Native Sheets API: GET https://sheets.googleapis.com/v4/spreadsheets/{id}/values/{range}\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/google-sheets/v4/spreadsheets/122BS1sFN2RKL8AOUQjkLdubzOwgqzPT64KfZ2rvYI4M/values/Sheet1!A1:B2')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF"
      },
      {
        "title": "Salesforce - SOQL Query (Native API)",
        "body": "# Native Salesforce API: GET https://{instance}.salesforce.com/services/data/v64.0/query?q=...\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/salesforce/services/data/v64.0/query?q=SELECT+Id,Name+FROM+Contact+LIMIT+10')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF"
      },
      {
        "title": "Airtable - List Tables (Native API)",
        "body": "# Native Airtable API: GET https://api.airtable.com/v0/meta/bases/{id}/tables\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/airtable/v0/meta/bases/appgqan2NzWGP5sBK/tables')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF"
      },
      {
        "title": "Notion - Query Database (Native API)",
        "body": "# Native Notion API: POST https://api.notion.com/v1/data_sources/{id}/query\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({}).encode()\nreq = urllib.request.Request('https://gateway.maton.ai/notion/v1/data_sources/23702dc5-9a3b-8001-9e1c-000b5af0a980/query', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json')\nreq.add_header('Notion-Version', '2025-09-03')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF"
      },
      {
        "title": "Stripe - List Customers (Native API)",
        "body": "# Native Stripe API: GET https://api.stripe.com/v1/customers\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/stripe/v1/customers?limit=10')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF"
      },
      {
        "title": "JavaScript (Node.js)",
        "body": "const response = await fetch('https://gateway.maton.ai/slack/api/chat.postMessage', {\n  method: 'POST',\n  headers: {\n    'Content-Type': 'application/json',\n    'Authorization': `Bearer ${process.env.MATON_API_KEY}`\n  },\n  body: JSON.stringify({ channel: 'C0123456', text: 'Hello!' })\n});"
      },
      {
        "title": "Python",
        "body": "import os\nimport requests\n\nresponse = requests.post(\n    'https://gateway.maton.ai/slack/api/chat.postMessage',\n    headers={'Authorization': f'Bearer {os.environ[\"MATON_API_KEY\"]}'},\n    json={'channel': 'C0123456', 'text': 'Hello!'}\n)"
      },
      {
        "title": "Error Handling",
        "body": "StatusMeaning400Missing connection for the requested app401Invalid or missing Maton API key429Rate limited (10 requests/second per account)500Internal Server Error4xx/5xxPassthrough error from the target API\n\nErrors from the target API are passed through with their original status codes and response bodies."
      },
      {
        "title": "Troubleshooting: API Key Issues",
        "body": "Check that the MATON_API_KEY environment variable is set:\n\necho $MATON_API_KEY\n\nVerify the API key is valid by listing connections:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://ctrl.maton.ai/connections')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF"
      },
      {
        "title": "Troubleshooting: Invalid App Name",
        "body": "Verify your URL path starts with the correct app name. The path must begin with /google-mail/. For example:\n\nCorrect: https://gateway.maton.ai/google-mail/gmail/v1/users/me/messages\nIncorrect: https://gateway.maton.ai/gmail/v1/users/me/messages\n\nEnsure you have an active connection for the app. List your connections to verify:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://ctrl.maton.ai/connections?app=google-mail&status=ACTIVE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF"
      },
      {
        "title": "Troubleshooting: Server Error",
        "body": "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."
      },
      {
        "title": "Rate Limits",
        "body": "10 requests per second per account\nTarget API rate limits also apply"
      },
      {
        "title": "Notes",
        "body": "When using curl with URLs containing brackets (fields[], sort[], records[]), use the -g flag to disable glob parsing\nWhen piping curl output to jq, environment variables may not expand correctly in some shells, which can cause \"Invalid API key\" errors"
      },
      {
        "title": "Tips",
        "body": "Use native API docs: Refer to each service's official API documentation for endpoint paths and parameters.\n\n\nHeaders are forwarded: Custom headers (except Host and Authorization) are forwarded to the target API.\n\n\nQuery params work: URL query parameters are passed through to the target API.\n\n\nAll HTTP methods supported: GET, POST, PUT, PATCH, DELETE are all supported.\n\n\nQuickBooks special case: Use :realmId in the path and it will be replaced with the connected realm ID."
      },
      {
        "title": "Optional",
        "body": "Github\nAPI Reference\nMaton Community\nMaton Support"
      }
    ],
    "body": "API Gateway\n\nPassthrough 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.\n\nQuick Start\n# Native Slack API call\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'channel': 'C0123456', 'text': 'Hello from gateway!'}).encode()\nreq = urllib.request.Request('https://gateway.maton.ai/slack/api/chat.postMessage', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nBase URL\nhttps://gateway.maton.ai/{app}/{native-api-path}\n\n\nReplace {app} with the service name and {native-api-path} with the actual API endpoint path.\n\nIMPORTANT: 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.\n\nAuthentication\n\nAll requests require the Maton API key in the Authorization header:\n\nAuthorization: Bearer $MATON_API_KEY\n\n\nThe API gateway automatically injects the appropriate OAuth token for the target service.\n\nEnvironment Variable: You can set your API key as the MATON_API_KEY environment variable:\n\nexport MATON_API_KEY=\"YOUR_API_KEY\"\n\nGetting Your API Key\nSign in or create an account at maton.ai\nGo to maton.ai/settings\nClick the copy button on the right side of API Key section to copy it\nConnection Management\n\nConnection management uses a separate base URL: https://ctrl.maton.ai\n\nList Connections\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://ctrl.maton.ai/connections?app=slack&status=ACTIVE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\n\nQuery Parameters (optional):\n\napp - Filter by service name (e.g., slack, hubspot, salesforce)\nstatus - Filter by connection status (ACTIVE, PENDING, FAILED)\n\nResponse:\n\n{\n  \"connections\": [\n    {\n      \"connection_id\": \"21fd90f9-5935-43cd-b6c8-bde9d915ca80\",\n      \"status\": \"ACTIVE\",\n      \"creation_time\": \"2025-12-08T07:20:53.488460Z\",\n      \"last_updated_time\": \"2026-01-31T20:03:32.593153Z\",\n      \"url\": \"https://connect.maton.ai/?session_token=5e9...\",\n      \"app\": \"slack\",\n      \"metadata\": {}\n    }\n  ]\n}\n\nCreate Connection\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'app': 'slack'}).encode()\nreq = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nGet Connection\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\n\nResponse:\n\n{\n  \"connection\": {\n    \"connection_id\": \"21fd90f9-5935-43cd-b6c8-bde9d915ca80\",\n    \"status\": \"ACTIVE\",\n    \"creation_time\": \"2025-12-08T07:20:53.488460Z\",\n    \"last_updated_time\": \"2026-01-31T20:03:32.593153Z\",\n    \"url\": \"https://connect.maton.ai/?session_token=5e9...\",\n    \"app\": \"slack\",\n    \"metadata\": {}\n  }\n}\n\n\nOpen the returned URL in a browser to complete OAuth.\n\nDelete Connection\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nSpecifying Connection\n\nIf 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:\n\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'channel': 'C0123456', 'text': 'Hello!'}).encode()\nreq = urllib.request.Request('https://gateway.maton.ai/slack/api/chat.postMessage', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json')\nreq.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\n\nIf omitted, the gateway uses the default (oldest) active connection for that app.\n\nSupported Services\nService\tApp Name\tBase URL Proxied\nActiveCampaign\tactive-campaign\t{account}.api-us1.com\nAcuity Scheduling\tacuity-scheduling\tacuityscheduling.com\nAirtable\tairtable\tapi.airtable.com\nApollo\tapollo\tapi.apollo.io\nAsana\tasana\tapp.asana.com\nAttio\tattio\tapi.attio.com\nBasecamp\tbasecamp\t3.basecampapi.com\nbeehiiv\tbeehiiv\tapi.beehiiv.com\nBox\tbox\tapi.box.com\nBrevo\tbrevo\tapi.brevo.com\nCalendly\tcalendly\tapi.calendly.com\nCal.com\tcal-com\tapi.cal.com\nCallRail\tcallrail\tapi.callrail.com\nChargebee\tchargebee\t{subdomain}.chargebee.com\nClickFunnels\tclickfunnels\t{subdomain}.myclickfunnels.com\nClickSend\tclicksend\trest.clicksend.com\nClickUp\tclickup\tapi.clickup.com\nClockify\tclockify\tapi.clockify.me\nCoda\tcoda\tcoda.io\nConfluence\tconfluence\tapi.atlassian.com\nCompanyCam\tcompanycam\tapi.companycam.com\nCognito Forms\tcognito-forms\twww.cognitoforms.com\nConstant Contact\tconstant-contact\tapi.cc.email\nDropbox\tdropbox\tapi.dropboxapi.com\nDropbox Business\tdropbox-business\tapi.dropboxapi.com\nElevenLabs\televenlabs\tapi.elevenlabs.io\nEventbrite\teventbrite\twww.eventbriteapi.com\nFathom\tfathom\tapi.fathom.ai\nFirebase\tfirebase\tfirebase.googleapis.com\nFireflies\tfireflies\tapi.fireflies.ai\nGetResponse\tgetresponse\tapi.getresponse.com\nGitHub\tgithub\tapi.github.com\nGumroad\tgumroad\tapi.gumroad.com\nGoogle Ads\tgoogle-ads\tgoogleads.googleapis.com\nGoogle BigQuery\tgoogle-bigquery\tbigquery.googleapis.com\nGoogle Analytics Admin\tgoogle-analytics-admin\tanalyticsadmin.googleapis.com\nGoogle Analytics Data\tgoogle-analytics-data\tanalyticsdata.googleapis.com\nGoogle Calendar\tgoogle-calendar\twww.googleapis.com\nGoogle Classroom\tgoogle-classroom\tclassroom.googleapis.com\nGoogle Contacts\tgoogle-contacts\tpeople.googleapis.com\nGoogle Docs\tgoogle-docs\tdocs.googleapis.com\nGoogle Drive\tgoogle-drive\twww.googleapis.com\nGoogle Forms\tgoogle-forms\tforms.googleapis.com\nGmail\tgoogle-mail\tgmail.googleapis.com\nGoogle Merchant\tgoogle-merchant\tmerchantapi.googleapis.com\nGoogle Meet\tgoogle-meet\tmeet.googleapis.com\nGoogle Play\tgoogle-play\tandroidpublisher.googleapis.com\nGoogle Search Console\tgoogle-search-console\twww.googleapis.com\nGoogle Sheets\tgoogle-sheets\tsheets.googleapis.com\nGoogle Slides\tgoogle-slides\tslides.googleapis.com\nGoogle Tasks\tgoogle-tasks\ttasks.googleapis.com\nGoogle Workspace Admin\tgoogle-workspace-admin\tadmin.googleapis.com\nHubSpot\thubspot\tapi.hubapi.com\nInstantly\tinstantly\tapi.instantly.ai\nJira\tjira\tapi.atlassian.com\nJobber\tjobber\tapi.getjobber.com\nJotForm\tjotform\tapi.jotform.com\nKeap\tkeap\tapi.infusionsoft.com\nKit\tkit\tapi.kit.com\nKlaviyo\tklaviyo\ta.klaviyo.com\nLemlist\tlemlist\tapi.lemlist.com\nLinear\tlinear\tapi.linear.app\nLinkedIn\tlinkedin\tapi.linkedin.com\nMailchimp\tmailchimp\t{dc}.api.mailchimp.com\nMailerLite\tmailerlite\tconnect.mailerlite.com\nMailgun\tmailgun\tapi.mailgun.net\nManyChat\tmanychat\tapi.manychat.com\nMicrosoft Excel\tmicrosoft-excel\tgraph.microsoft.com\nMicrosoft Teams\tmicrosoft-teams\tgraph.microsoft.com\nMicrosoft To Do\tmicrosoft-to-do\tgraph.microsoft.com\nMonday.com\tmonday\tapi.monday.com\nMotion\tmotion\tapi.usemotion.com\nNetlify\tnetlify\tapi.netlify.com\nNotion\tnotion\tapi.notion.com\nOneDrive\tone-drive\tgraph.microsoft.com\nOutlook\toutlook\tgraph.microsoft.com\nPDF.co\tpdf-co\tapi.pdf.co\nPipedrive\tpipedrive\tapi.pipedrive.com\nPodio\tpodio\tapi.podio.com\nQuickBooks\tquickbooks\tquickbooks.api.intuit.com\nQuo\tquo\tapi.openphone.com\nSalesforce\tsalesforce\t{instance}.salesforce.com\nSignNow\tsignnow\tapi.signnow.com\nSlack\tslack\tslack.com\nSnapchat\tsnapchat\tadsapi.snapchat.com\nSquare\tsquareup\tconnect.squareup.com\nStripe\tstripe\tapi.stripe.com\nSysteme.io\tsysteme\tapi.systeme.io\nTally\ttally\tapi.tally.so\nTelegram\ttelegram\tapi.telegram.org\nTickTick\tticktick\tapi.ticktick.com\nTodoist\ttodoist\tapi.todoist.com\nToggl Track\ttoggl-track\tapi.track.toggl.com\nTrello\ttrello\tapi.trello.com\nTwilio\ttwilio\tapi.twilio.com\nTypeform\ttypeform\tapi.typeform.com\nVimeo\tvimeo\tapi.vimeo.com\nWhatsApp Business\twhatsapp-business\tgraph.facebook.com\nWooCommerce\twoocommerce\t{store-url}/wp-json/wc/v3\nWordPress.com\twordpress\tpublic-api.wordpress.com\nXero\txero\tapi.xero.com\nYouTube\tyoutube\twww.googleapis.com\nZoho Bigin\tzoho-bigin\twww.zohoapis.com\nZoho Bookings\tzoho-bookings\twww.zohoapis.com\nZoho Books\tzoho-books\twww.zohoapis.com\nZoho Calendar\tzoho-calendar\tcalendar.zoho.com\nZoho CRM\tzoho-crm\twww.zohoapis.com\nZoho Inventory\tzoho-inventory\twww.zohoapis.com\nZoho Mail\tzoho-mail\tmail.zoho.com\nZoho People\tzoho-people\tpeople.zoho.com\nZoho Recruit\tzoho-recruit\trecruit.zoho.com\n\nSee references/ for detailed routing guides per provider:\n\nActiveCampaign - Contacts, deals, tags, lists, automations, campaigns\nAcuity Scheduling - Appointments, calendars, clients, availability\nAirtable - Records, bases, tables\nApollo - People search, enrichment, contacts\nAsana - Tasks, projects, workspaces, webhooks\nAttio - People, companies, records, tasks\nBasecamp - Projects, to-dos, messages, schedules, documents\nbeehiiv - Publications, subscriptions, posts, custom fields\nBox - Files, folders, collaborations, shared links\nBrevo - Contacts, email campaigns, transactional emails, templates\nCalendly - Event types, scheduled events, availability, webhooks\nCal.com - Event types, bookings, schedules, availability slots, webhooks\nCallRail - Calls, trackers, companies, tags, analytics\nChargebee - Subscriptions, customers, invoices\nClickFunnels - Contacts, products, orders, courses, webhooks\nClickSend - SMS, MMS, voice messages, contacts, lists\nClickUp - Tasks, lists, folders, spaces, webhooks\nClockify - Time tracking, projects, clients, tasks, workspaces\nCoda - Docs, pages, tables, rows, formulas, controls\nConfluence - Pages, spaces, blogposts, comments, attachments\nCompanyCam - Projects, photos, users, tags, groups, documents\nCognito Forms - Forms, entries, documents, files\nConstant Contact - Contacts, email campaigns, lists, segments\nDropbox - Files, folders, search, metadata, revisions, tags\nDropbox Business - Team members, groups, team folders, devices, audit logs\nElevenLabs - Text-to-speech, voice cloning, sound effects, audio processing\nEventbrite - Events, venues, tickets, orders, attendees\nFathom - Meeting recordings, transcripts, summaries, webhooks\nFirebase - Projects, web apps, Android apps, iOS apps, configurations\nFireflies - Meeting transcripts, summaries, AskFred AI, channels\nGetResponse - Campaigns, contacts, newsletters, autoresponders, tags, segments\nGitHub - Repositories, issues, pull requests, commits\nGumroad - Products, sales, subscribers, licenses, webhooks\nGoogle Ads - Campaigns, ad groups, GAQL queries\nGoogle Analytics Admin - Reports, dimensions, metrics\nGoogle Analytics Data - Reports, dimensions, metrics\nGoogle BigQuery - Datasets, tables, jobs, SQL queries\nGoogle Calendar - Events, calendars, free/busy\nGoogle Classroom - Courses, coursework, students, teachers, announcements\nGoogle Contacts - Contacts, contact groups, people search\nGoogle Docs - Document creation, batch updates\nGoogle Drive - Files, folders, permissions\nGoogle Forms - Forms, questions, responses\nGmail - Messages, threads, labels\nGoogle Meet - Spaces, conference records, participants\nGoogle Merchant - Products, inventories, promotions, reports\nGoogle Play - In-app products, subscriptions, reviews\nGoogle Search Console - Search analytics, sitemaps\nGoogle Sheets - Values, ranges, formatting\nGoogle Slides - Presentations, slides, formatting\nGoogle Tasks - Task lists, tasks, subtasks\nGoogle Workspace Admin - Users, groups, org units, domains, roles\nHubSpot - Contacts, companies, deals\nInstantly - Campaigns, leads, accounts, email outreach\nJira - Issues, projects, JQL queries\nJobber - Clients, jobs, invoices, quotes (GraphQL)\nJotForm - Forms, submissions, webhooks\nKeap - Contacts, companies, tags, tasks, opportunities, campaigns\nKit - Subscribers, tags, forms, sequences, broadcasts\nKlaviyo - Profiles, lists, campaigns, flows, events\nLemlist - Campaigns, leads, activities, schedules, unsubscribes\nLinear - Issues, projects, teams, cycles (GraphQL)\nLinkedIn - Profile, posts, shares, media uploads\nMailchimp - Audiences, campaigns, templates, automations\nMailerLite - Subscribers, groups, campaigns, automations, forms\nMailgun - Email sending, domains, routes, templates, mailing lists, suppressions\nManyChat - Subscribers, tags, flows, messaging\nMicrosoft Excel - Workbooks, worksheets, ranges, tables, charts\nMicrosoft Teams - Teams, channels, messages, members, chats\nMicrosoft To Do - Task lists, tasks, checklist items, linked resources\nMonday.com - Boards, items, columns, groups (GraphQL)\nMotion - Tasks, projects, workspaces, schedules\nNetlify - Sites, deploys, builds, DNS, environment variables\nNotion - Pages, databases, blocks\nOneDrive - Files, folders, drives, sharing\nOutlook - Mail, calendar, contacts\nPDF.co - PDF conversion, merge, split, edit, text extraction, barcodes\nPipedrive - Deals, persons, organizations, activities\nPodio - Organizations, workspaces, apps, items, tasks, comments\nQuickBooks - Customers, invoices, reports\nQuo - Calls, messages, contacts, conversations, webhooks\nSalesforce - SOQL, sObjects, CRUD\nSignNow - Documents, templates, invites, e-signatures\nSendGrid - Email sending, contacts, templates, suppressions, statistics\nSlack - Messages, channels, users\nSnapchat - Ad accounts, campaigns, ad squads, ads, creatives, audiences\nSquare - Payments, customers, orders, catalog, inventory, invoices\nStripe - Customers, subscriptions, payments\nSysteme.io - Contacts, tags, courses, communities, webhooks\nTally - Forms, submissions, workspaces, webhooks\nTelegram - Messages, chats, bots, updates, polls\nTickTick - Tasks, projects, task lists\nTodoist - Tasks, projects, sections, labels, comments\nToggl Track - Time entries, projects, clients, tags, workspaces\nTrello - Boards, lists, cards, checklists\nTwilio - SMS, voice calls, phone numbers, messaging\nTypeform - Forms, responses, insights\nVimeo - Videos, folders, albums, comments, likes\nWhatsApp Business - Messages, templates, media\nWooCommerce - Products, orders, customers, coupons\nWordPress.com - Posts, pages, sites, users, settings\nXero - Contacts, invoices, reports\nYouTube - Videos, playlists, channels, subscriptions\nZoho Bigin - Contacts, companies, pipelines, products\nZoho Bookings - Appointments, services, staff, workspaces\nZoho Books - Invoices, contacts, bills, expenses\nZoho Calendar - Calendars, events, attendees, reminders\nZoho CRM - Leads, contacts, accounts, deals, search\nZoho Inventory - Items, sales orders, invoices, purchase orders, bills\nZoho Mail - Messages, folders, labels, attachments\nZoho People - Employees, departments, designations, attendance, leave\nZoho Recruit - Candidates, job openings, interviews, applications\nExamples\nSlack - Post Message (Native API)\n# Native Slack API: POST https://slack.com/api/chat.postMessage\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'channel': 'C0123456', 'text': 'Hello!'}).encode()\nreq = urllib.request.Request('https://gateway.maton.ai/slack/api/chat.postMessage', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json; charset=utf-8')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nHubSpot - Create Contact (Native API)\n# Native HubSpot API: POST https://api.hubapi.com/crm/v3/objects/contacts\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'properties': {'email': 'john@example.com', 'firstname': 'John', 'lastname': 'Doe'}}).encode()\nreq = urllib.request.Request('https://gateway.maton.ai/hubspot/crm/v3/objects/contacts', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nGoogle Sheets - Get Spreadsheet Values (Native API)\n# Native Sheets API: GET https://sheets.googleapis.com/v4/spreadsheets/{id}/values/{range}\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/google-sheets/v4/spreadsheets/122BS1sFN2RKL8AOUQjkLdubzOwgqzPT64KfZ2rvYI4M/values/Sheet1!A1:B2')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nSalesforce - SOQL Query (Native API)\n# Native Salesforce API: GET https://{instance}.salesforce.com/services/data/v64.0/query?q=...\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/salesforce/services/data/v64.0/query?q=SELECT+Id,Name+FROM+Contact+LIMIT+10')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nAirtable - List Tables (Native API)\n# Native Airtable API: GET https://api.airtable.com/v0/meta/bases/{id}/tables\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/airtable/v0/meta/bases/appgqan2NzWGP5sBK/tables')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nNotion - Query Database (Native API)\n# Native Notion API: POST https://api.notion.com/v1/data_sources/{id}/query\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({}).encode()\nreq = urllib.request.Request('https://gateway.maton.ai/notion/v1/data_sources/23702dc5-9a3b-8001-9e1c-000b5af0a980/query', data=data, method='POST')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Content-Type', 'application/json')\nreq.add_header('Notion-Version', '2025-09-03')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nStripe - List Customers (Native API)\n# Native Stripe API: GET https://api.stripe.com/v1/customers\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/stripe/v1/customers?limit=10')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nCode Examples\nJavaScript (Node.js)\nconst response = await fetch('https://gateway.maton.ai/slack/api/chat.postMessage', {\n  method: 'POST',\n  headers: {\n    'Content-Type': 'application/json',\n    'Authorization': `Bearer ${process.env.MATON_API_KEY}`\n  },\n  body: JSON.stringify({ channel: 'C0123456', text: 'Hello!' })\n});\n\nPython\nimport os\nimport requests\n\nresponse = requests.post(\n    'https://gateway.maton.ai/slack/api/chat.postMessage',\n    headers={'Authorization': f'Bearer {os.environ[\"MATON_API_KEY\"]}'},\n    json={'channel': 'C0123456', 'text': 'Hello!'}\n)\n\nError Handling\nStatus\tMeaning\n400\tMissing connection for the requested app\n401\tInvalid or missing Maton API key\n429\tRate limited (10 requests/second per account)\n500\tInternal Server Error\n4xx/5xx\tPassthrough error from the target API\n\nErrors from the target API are passed through with their original status codes and response bodies.\n\nTroubleshooting: API Key Issues\nCheck that the MATON_API_KEY environment variable is set:\necho $MATON_API_KEY\n\nVerify the API key is valid by listing connections:\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://ctrl.maton.ai/connections')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nTroubleshooting: Invalid App Name\nVerify your URL path starts with the correct app name. The path must begin with /google-mail/. For example:\nCorrect: https://gateway.maton.ai/google-mail/gmail/v1/users/me/messages\nIncorrect: https://gateway.maton.ai/gmail/v1/users/me/messages\nEnsure you have an active connection for the app. List your connections to verify:\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://ctrl.maton.ai/connections?app=google-mail&status=ACTIVE')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\nTroubleshooting: Server Error\n\nA 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.\n\nRate Limits\n10 requests per second per account\nTarget API rate limits also apply\nNotes\nWhen using curl with URLs containing brackets (fields[], sort[], records[]), use the -g flag to disable glob parsing\nWhen piping curl output to jq, environment variables may not expand correctly in some shells, which can cause \"Invalid API key\" errors\nTips\n\nUse native API docs: Refer to each service's official API documentation for endpoint paths and parameters.\n\nHeaders are forwarded: Custom headers (except Host and Authorization) are forwarded to the target API.\n\nQuery params work: URL query parameters are passed through to the target API.\n\nAll HTTP methods supported: GET, POST, PUT, PATCH, DELETE are all supported.\n\nQuickBooks special case: Use :realmId in the path and it will be replaced with the connected realm ID.\n\nOptional\nGithub\nAPI Reference\nMaton Community\nMaton Support"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/kdegeek/api-gateway-1",
    "publisherUrl": "https://clawhub.ai/kdegeek/api-gateway-1",
    "owner": "kdegeek",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/api-gateway-1",
    "downloadUrl": "https://openagent3.xyz/downloads/api-gateway-1",
    "agentUrl": "https://openagent3.xyz/skills/api-gateway-1/agent",
    "manifestUrl": "https://openagent3.xyz/skills/api-gateway-1/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/api-gateway-1/agent.md"
  }
}