Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
API gateway for calling third-party APIs with managed auth. Use this skill when users want to interact with external services like Slack, HubSpot, Salesforce...
API gateway for calling third-party APIs with managed auth. Use this skill when users want to interact with external services like Slack, HubSpot, Salesforce...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
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.
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.
Passthrough proxy for direct access to third-party APIs using managed auth connections. The API gateway lets you call native API endpoints directly.
# Native Slack API call curl -s -X POST "https://gateway.maton.ai/slack/api/chat.postMessage" -H "Content-Type: application/json" -H "Authorization: Bearer $MATON_API_KEY" -d '{"channel": "C0123456", "text": "Hello from gateway!"}' IMPORTANT: If you receive a 500 Internal Server Error, this does NOT mean the service is unsupported. The most common cause is an expired OAuth refresh token (connections older than 1 month). See the "Troubleshooting 500 Internal Server Error" section below to create a new connection and retry with the new connection ID.
https://gateway.maton.ai/{app}/{native-api-path} Replace {app} with the service name and {native-api-path} with the actual API endpoint path.
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"
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 uses a separate base URL: https://ctrl.maton.ai
curl -s -X GET "https://ctrl.maton.ai/connections?app=slack&status=ACTIVE" -H "Authorization: Bearer $MATON_API_KEY" Query Parameters (optional): app - Filter by service name (e.g., slack, hubspot, salesforce) status - Filter by connection status (ACTIVE, PENDING, FAILED) Response: { "connections": [ { "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80", "status": "ACTIVE", "creation_time": "2025-12-08T07:20:53.488460Z", "last_updated_time": "2026-01-31T20:03:32.593153Z", "url": "https://connect.maton.ai/?session_token=5e9...", "app": "slack", "metadata": {} } ] }
curl -s -X POST "https://ctrl.maton.ai/connections" -H "Content-Type: application/json" -H "Authorization: Bearer $MATON_API_KEY" -d '{"app": "slack"}'
curl -s -X GET "https://ctrl.maton.ai/connections/{connection_id}" -H "Authorization: Bearer $MATON_API_KEY" Response: { "connection": { "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80", "status": "ACTIVE", "creation_time": "2025-12-08T07:20:53.488460Z", "last_updated_time": "2026-01-31T20:03:32.593153Z", "url": "https://connect.maton.ai/?session_token=5e9...", "app": "slack", "metadata": {} } } Open the returned URL in a browser to complete OAuth.
curl -s -X DELETE "https://ctrl.maton.ai/connections/{connection_id}" -H "Authorization: Bearer $MATON_API_KEY"
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: curl -s -X POST "https://gateway.maton.ai/slack/api/chat.postMessage" -H "Content-Type: application/json" -H "Authorization: Bearer $MATON_API_KEY" -H "Maton-Connection: 21fd90f9-5935-43cd-b6c8-bde9d915ca80" -d '{"channel": "C0123456", "text": "Hello!"}' If omitted, the gateway uses the default (oldest) active connection for that app.
ServiceApp NameBase URL ProxiedAirtableairtableapi.airtable.comApolloapolloapi.apollo.ioAsanaasanaapp.asana.comCalendlycalendlyapi.calendly.comChargebeechargebee{subdomain}.chargebee.comClickUpclickupapi.clickup.comFathomfathomapi.fathom.aiGoogle Adsgoogle-adsgoogleads.googleapis.comGoogle Analytics Admingoogle-analytics-adminanalyticsadmin.googleapis.comGoogle Analytics Datagoogle-analytics-dataanalyticsdata.googleapis.comGoogle Calendargoogle-calendarwww.googleapis.comGoogle Docsgoogle-docsdocs.googleapis.comGoogle Drivegoogle-drivewww.googleapis.comGoogle Formsgoogle-formsforms.googleapis.comGmailgoogle-mailgmail.googleapis.comGoogle Meetgoogle-meetmeet.googleapis.comGoogle Playgoogle-playandroidpublisher.googleapis.comGoogle Search Consolegoogle-search-consolewww.googleapis.comGoogle Sheetsgoogle-sheetssheets.googleapis.comGoogle Slidesgoogle-slidesslides.googleapis.comHubSpothubspotapi.hubapi.comJirajiraapi.atlassian.comJotFormjotformapi.jotform.comKlaviyoklaviyoa.klaviyo.comMailchimpmailchimp{dc}.api.mailchimp.comNotionnotionapi.notion.comOutlookoutlookgraph.microsoft.comPipedrivepipedriveapi.pipedrive.comQuickBooksquickbooksquickbooks.api.intuit.comSalesforcesalesforce{instance}.salesforce.comSlackslackslack.comStripestripeapi.stripe.comTrellotrelloapi.trello.comTypeformtypeformapi.typeform.comWhatsApp Businesswhatsapp-businessgraph.facebook.comWooCommercewoocommerce{store-url}/wp-json/wc/v3Xeroxeroapi.xero.comYouTubeyoutubewww.googleapis.com See references/ for detailed routing guides per provider: Airtable - Records, bases, tables Apollo - People search, enrichment, contacts Asana - Tasks, projects, workspaces, webhooks Calendly - Event types, scheduled events, availability, webhooks Chargebee - Subscriptions, customers, invoices ClickUp - Tasks, lists, folders, spaces, webhooks Fathom - Meeting recordings, transcripts, summaries, webhooks Google Ads - Campaigns, ad groups, GAQL queries Google Analytics Admin - Reports, dimensions, metrics Google Analytics Data - Reports, dimensions, metrics Google Calendar - Events, calendars, free/busy Google Docs - Document creation, batch updates Google Drive - Files, folders, permissions Google Forms - Forms, questions, responses Gmail - Messages, threads, labels Google Meet - Spaces, conference records, participants Google Play - In-app products, subscriptions, reviews Google Search Console - Search analytics, sitemaps Google Sheets - Values, ranges, formatting Google Slides - Presentations, slides, formatting HubSpot - Contacts, companies, deals Jira - Issues, projects, JQL queries JotForm - Forms, submissions, webhooks Klaviyo - Profiles, lists, campaigns, flows, events Mailchimp - Audiences, campaigns, templates, automations Notion - Pages, databases, blocks Outlook - Mail, calendar, contacts Pipedrive - Deals, persons, organizations, activities QuickBooks - Customers, invoices, reports Salesforce - SOQL, sObjects, CRUD Slack - Messages, channels, users Stripe - Customers, subscriptions, payments Trello - Boards, lists, cards, checklists Typeform - Forms, responses, insights WhatsApp Business - Messages, templates, media WooCommerce - Products, orders, customers, coupons Xero - Contacts, invoices, reports YouTube - Videos, playlists, channels, subscriptions
# Native Slack API: POST https://slack.com/api/chat.postMessage curl -s -X POST "https://gateway.maton.ai/slack/api/chat.postMessage" -H "Content-Type: application/json; charset=utf-8" -H "Authorization: Bearer $MATON_API_KEY" -d '{"channel": "C0123456", "text": "Hello!"}'
# Native HubSpot API: POST https://api.hubapi.com/crm/v3/objects/contacts curl -s -X POST "https://gateway.maton.ai/hubspot/crm/v3/objects/contacts" -H "Content-Type: application/json" -H "Authorization: Bearer $MATON_API_KEY" -d '{"properties": {"email": "john@example.com", "firstname": "John", "lastname": "Doe"}}'
# Native Sheets API: GET https://sheets.googleapis.com/v4/spreadsheets/{id}/values/{range} curl -s -X GET "https://gateway.maton.ai/google-sheets/v4/spreadsheets/122BS1sFN2RKL8AOUQjkLdubzOwgqzPT64KfZ2rvYI4M/values/Sheet1!A1:B2" -H "Authorization: Bearer $MATON_API_KEY"
# Native Salesforce API: GET https://{instance}.salesforce.com/services/data/v64.0/query?q=... curl -s -X GET "https://gateway.maton.ai/salesforce/services/data/v64.0/query?q=SELECT+Id,Name+FROM+Contact+LIMIT+10" -H "Authorization: Bearer $MATON_API_KEY"
# Native Airtable API: GET https://api.airtable.com/v0/meta/bases/{id}/tables curl -s -X GET "https://gateway.maton.ai/airtable/v0/meta/bases/appgqan2NzWGP5sBK/tables" -H "Authorization: Bearer $MATON_API_KEY"
# Native Notion API: POST https://api.notion.com/v1/data_sources/{id}/query curl -s -X POST "https://gateway.maton.ai/notion/v1/data_sources/23702dc5-9a3b-8001-9e1c-000b5af0a980/query" -H "Content-Type: application/json" -H "Authorization: Bearer $MATON_API_KEY" -H "Notion-Version: 2025-09-03" -d '{}'
# Native Stripe API: GET https://api.stripe.com/v1/customers curl -s -X GET "https://gateway.maton.ai/stripe/v1/customers?limit=10" -H "Authorization: Bearer $MATON_API_KEY"
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!' }) });
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!'} )
StatusMeaning400Missing connection for the requested app401Invalid or missing Maton API key429Rate limited (10 requests/second per account)500Internal Server Error (see troubleshooting below)4xx/5xxPassthrough error from the target API Errors from the target API are passed through with their original status codes and response bodies.
IMPORTANT: A 500 Internal Server Error does NOT mean the service is unsupported. If the app is listed in the Supported Services table above, the error is likely due to an expired OAuth refresh token. When you receive a 500 Internal Server Error, ALWAYS follow these steps before concluding there is an issue: Connections that have been active for more than 1 month may have expired OAuth refresh tokens. To resolve: Create a new connection for the app: curl -s -X POST "https://ctrl.maton.ai/connections" -H "Content-Type: application/json" -H "Authorization: Bearer $MATON_API_KEY" -d '{"app": "APP_NAME"}' Get the OAuth URL by calling the GET connection endpoint with the new connection ID from step 1: curl -s -X GET "https://ctrl.maton.ai/connections/NEW_CONNECTION_ID" -H "Authorization: Bearer $MATON_API_KEY" Share the returned url with the user and ask them to complete the OAuth flow in their browser. After the user completes OAuth, retry the original request using the new connection ID via the Maton-Connection header: curl -s -X GET "https://gateway.maton.ai/APP_NAME/..." -H "Authorization: Bearer $MATON_API_KEY" -H "Maton-Connection: NEW_CONNECTION_ID" Once the new connection status is ACTIVE and working, ask the user if they want to delete the old connection: curl -s -X DELETE "https://ctrl.maton.ai/connections/OLD_CONNECTION_ID" -H "Authorization: Bearer $MATON_API_KEY"
10 requests per second per account Target API rate limits also apply
IMPORTANT: When using curl commands, use curl -g when URLs contain brackets (fields[], sort[], records[]) to disable glob parsing IMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments. You may get "Invalid API key" errors when piping.
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.
Github Documentation Community
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.