Content
\",\n \"public\": false,\n \"published_at\": null,\n \"send_at\": null,\n \"email_template\": {\"id\": 123, \"name\": \"Text only\"}\n }\n ],\n \"pagination\": {...}\n}" }, { "title": "Segments", "body": "List Segments\n\nGET /kit/v4/segments\n\nQuery parameters: per_page, after, before, include_total_count" }, { "title": "Custom Fields", "body": "List Custom Fields\n\nGET /kit/v4/custom_fields\n\nResponse:\n\n{\n \"custom_fields\": [\n {\n \"id\": 1192946,\n \"name\": \"ck_field_1192946_company\",\n \"key\": \"company\",\n \"label\": \"Company\"\n }\n ],\n \"pagination\": {...}\n}\n\nCreate Custom Field\n\nPOST /kit/v4/custom_fields\nContent-Type: application/json\n\n{\n \"label\": \"Company\"\n}\n\nUpdate Custom Field\n\nPUT /kit/v4/custom_fields/{id}\nContent-Type: application/json\n\n{\n \"label\": \"Company Name\"\n}\n\nDelete Custom Field\n\nDELETE /kit/v4/custom_fields/{id}\n\nReturns 204 No Content on success." }, { "title": "Purchases", "body": "List Purchases\n\nGET /kit/v4/purchases\n\nQuery parameters: per_page, after, before, include_total_count" }, { "title": "Email Templates", "body": "List Email Templates\n\nGET /kit/v4/email_templates\n\nResponse:\n\n{\n \"email_templates\": [\n {\n \"id\": 4956167,\n \"name\": \"Text only\",\n \"is_default\": true,\n \"category\": \"Classic\"\n }\n ],\n \"pagination\": {...}\n}" }, { "title": "Webhooks", "body": "List Webhooks\n\nGET /kit/v4/webhooks\n\nCreate Webhook\n\nPOST /kit/v4/webhooks\nContent-Type: application/json\n\n{\n \"target_url\": \"https://example.com/webhook\",\n \"event\": {\"name\": \"subscriber.subscriber_activate\"}\n}\n\nResponse:\n\n{\n \"webhook\": {\n \"id\": 5291560,\n \"account_id\": 2596262,\n \"event\": {\n \"name\": \"subscriber_activate\",\n \"initiator_value\": null\n },\n \"target_url\": \"https://example.com/webhook\"\n }\n}\n\nDelete Webhook\n\nDELETE /kit/v4/webhooks/{id}\n\nReturns 204 No Content on success." }, { "title": "Pagination", "body": "Kit uses cursor-based pagination. Use after and before query parameters with cursor values from the response.\n\nGET /kit/v4/subscribers?per_page=100&after=WzE0OV0=\n\nResponse includes pagination info:\n\n{\n \"subscribers\": [...],\n \"pagination\": {\n \"has_previous_page\": false,\n \"has_next_page\": true,\n \"start_cursor\": \"WzE0OV0=\",\n \"end_cursor\": \"WzI0OV0=\",\n \"per_page\": 100\n }\n}" }, { "title": "JavaScript", "body": "const response = await fetch(\n 'https://gateway.maton.ai/kit/v4/subscribers?per_page=10',\n {\n headers: {\n 'Authorization': `Bearer ${process.env.MATON_API_KEY}`\n }\n }\n);\nconst data = await response.json();" }, { "title": "Python", "body": "import os\nimport requests\n\nresponse = requests.get(\n 'https://gateway.maton.ai/kit/v4/subscribers',\n headers={'Authorization': f'Bearer {os.environ[\"MATON_API_KEY\"]}'},\n params={'per_page': 10}\n)\ndata = response.json()" }, { "title": "Notes", "body": "Kit API uses V4 (V3 is deprecated)\nSubscriber IDs are integers\nCustom field keys are auto-generated from labels\nBulk operations (>100 items) are processed asynchronously\nDelete operations return 204 No Content with empty body\nIMPORTANT: When using curl commands, use curl -g when URLs contain brackets to disable glob parsing\nIMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments" }, { "title": "Error Handling", "body": "StatusMeaning400Missing Kit connection401Invalid or missing Maton API key403Insufficient permissions (check OAuth scopes)404Resource not found429Rate limited4xx/5xxPassthrough error from Kit API" }, { "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": "Ensure your URL path starts with kit. For example:\n\nCorrect: https://gateway.maton.ai/kit/v4/subscribers\nIncorrect: https://gateway.maton.ai/v4/subscribers" }, { "title": "Resources", "body": "Kit API Overview\nKit API Subscribers\nKit API Tags\nKit API Forms\nMaton Community\nMaton Support" } ], "body": "Kit\n\nAccess the Kit (formerly ConvertKit) API with managed OAuth authentication. Manage subscribers, tags, forms, sequences, broadcasts, custom fields, and webhooks.\n\nQuick Start\n# List subscribers\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/kit/v4/subscribers?per_page=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\nBase URL\nhttps://gateway.maton.ai/kit/{native-api-path}\n\n\nReplace {native-api-path} with the actual Kit API endpoint path. The gateway proxies requests to api.kit.com and automatically injects your OAuth token.\n\nAuthentication\n\nAll requests require the Maton API key in the Authorization header:\n\nAuthorization: Bearer $MATON_API_KEY\n\n\nEnvironment Variable: Set your API key as MATON_API_KEY:\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\nCopy your API key\nConnection Management\n\nManage your Kit OAuth connections at https://ctrl.maton.ai.\n\nList Connections\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://ctrl.maton.ai/connections?app=kit&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\nCreate Connection\npython <<'EOF'\nimport urllib.request, os, json\ndata = json.dumps({'app': 'kit'}).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\": \"cb2025b3-706f-4b5d-87a5-c6809c0c7ec4\",\n \"status\": \"ACTIVE\",\n \"creation_time\": \"2026-02-07T00:04:08.476727Z\",\n \"last_updated_time\": \"2026-02-07T00:05:58.001964Z\",\n \"url\": \"https://connect.maton.ai/?session_token=...\",\n \"app\": \"kit\",\n \"metadata\": {}\n }\n}\n\n\nOpen the returned url in a browser to complete OAuth authorization.\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 Kit connections, specify which one to use with the Maton-Connection header:\n\npython <<'EOF'\nimport urllib.request, os, json\nreq = urllib.request.Request('https://gateway.maton.ai/kit/v4/subscribers')\nreq.add_header('Authorization', f'Bearer {os.environ[\"MATON_API_KEY\"]}')\nreq.add_header('Maton-Connection', 'cb2025b3-706f-4b5d-87a5-c6809c0c7ec4')\nprint(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))\nEOF\n\n\nIf omitted, the gateway uses the default (oldest) active connection.\n\nAPI Reference\nSubscribers\nList Subscribers\nGET /kit/v4/subscribers\n\n\nQuery parameters:\n\nper_page - Results per page (default: 500, max: 1000)\nafter - Cursor for next page\nbefore - Cursor for previous page\nstatus - Filter by: active, inactive, bounced, complained, cancelled, or all\nemail_address - Filter by specific email\ncreated_after / created_before - Filter by creation date (yyyy-mm-dd)\nupdated_after / updated_before - Filter by update date (yyyy-mm-dd)\ninclude_total_count - Include total count (slower)\n\nResponse:\n\n{\n \"subscribers\": [\n {\n \"id\": 3914682852,\n \"first_name\": \"Test User\",\n \"email_address\": \"test@example.com\",\n \"state\": \"active\",\n \"created_at\": \"2026-02-07T00:42:54Z\",\n \"fields\": {\"company\": null}\n }\n ],\n \"pagination\": {\n \"has_previous_page\": false,\n \"has_next_page\": false,\n \"start_cursor\": \"WzE0OV0=\",\n \"end_cursor\": \"WzE0OV0=\",\n \"per_page\": 500\n }\n}\n\nGet Subscriber\nGET /kit/v4/subscribers/{id}\n\nCreate Subscriber\nPOST /kit/v4/subscribers\nContent-Type: application/json\n\n{\n \"email_address\": \"user@example.com\",\n \"first_name\": \"John\"\n}\n\nUpdate Subscriber\nPUT /kit/v4/subscribers/{id}\nContent-Type: application/json\n\n{\n \"first_name\": \"Updated Name\"\n}\n\nTags\nList Tags\nGET /kit/v4/tags\n\n\nQuery parameters: per_page, after, before, include_total_count\n\nCreate Tag\nPOST /kit/v4/tags\nContent-Type: application/json\n\n{\n \"name\": \"new-tag\"\n}\n\n\nResponse:\n\n{\n \"tag\": {\n \"id\": 15690016,\n \"name\": \"new-tag\",\n \"created_at\": \"2026-02-07T00:42:53Z\"\n }\n}\n\nUpdate Tag\nPUT /kit/v4/tags/{id}\nContent-Type: application/json\n\n{\n \"name\": \"updated-tag-name\"\n}\n\nDelete Tag\nDELETE /kit/v4/tags/{id}\n\n\nReturns 204 No Content on success.\n\nTag a Subscriber\nPOST /kit/v4/tags/{tag_id}/subscribers\nContent-Type: application/json\n\n{\n \"email_address\": \"user@example.com\"\n}\n\nRemove Tag from Subscriber\nDELETE /kit/v4/tags/{tag_id}/subscribers/{subscriber_id}\n\n\nReturns 204 No Content on success.\n\nList Subscribers with Tag\nGET /kit/v4/tags/{tag_id}/subscribers\n\nForms\nList Forms\nGET /kit/v4/forms\n\n\nQuery parameters:\n\nper_page, after, before, include_total_count\nstatus - Filter by: active, archived, trashed, or all\ntype - embed for embedded forms, hosted for landing pages\n\nResponse:\n\n{\n \"forms\": [\n {\n \"id\": 9061198,\n \"name\": \"Creator Profile\",\n \"created_at\": \"2026-02-07T00:00:32Z\",\n \"type\": \"embed\",\n \"format\": null,\n \"embed_js\": \"https://chris-kim-2.kit.com/c682763b07/index.js\",\n \"embed_url\": \"https://chris-kim-2.kit.com/c682763b07\",\n \"archived\": false,\n \"uid\": \"c682763b07\"\n }\n ],\n \"pagination\": {...}\n}\n\nAdd Subscriber to Form\nPOST /kit/v4/forms/{form_id}/subscribers\nContent-Type: application/json\n\n{\n \"email_address\": \"user@example.com\"\n}\n\nList Form Subscribers\nGET /kit/v4/forms/{form_id}/subscribers\n\nSequences\nList Sequences\nGET /kit/v4/sequences\n\n\nResponse:\n\n{\n \"sequences\": [\n {\n \"id\": 123,\n \"name\": \"Welcome Sequence\",\n \"hold\": false,\n \"repeat\": false,\n \"created_at\": \"2026-01-01T00:00:00Z\"\n }\n ],\n \"pagination\": {...}\n}\n\nAdd Subscriber to Sequence\nPOST /kit/v4/sequences/{sequence_id}/subscribers\nContent-Type: application/json\n\n{\n \"email_address\": \"user@example.com\"\n}\n\nList Sequence Subscribers\nGET /kit/v4/sequences/{sequence_id}/subscribers\n\nBroadcasts\nList Broadcasts\nGET /kit/v4/broadcasts\n\n\nQuery parameters: per_page, after, before, include_total_count\n\nResponse:\n\n{\n \"broadcasts\": [\n {\n \"id\": 123,\n \"publication_id\": 456,\n \"created_at\": \"2026-02-07T00:00:00Z\",\n \"subject\": \"My Broadcast\",\n \"preview_text\": \"Preview...\",\n \"content\": \"Content
\",\n \"public\": false,\n \"published_at\": null,\n \"send_at\": null,\n \"email_template\": {\"id\": 123, \"name\": \"Text only\"}\n }\n ],\n \"pagination\": {...}\n}\n\nSegments\nList Segments\nGET /kit/v4/segments\n\n\nQuery parameters: per_page, after, before, include_total_count\n\nCustom Fields\nList Custom Fields\nGET /kit/v4/custom_fields\n\n\nResponse:\n\n{\n \"custom_fields\": [\n {\n \"id\": 1192946,\n \"name\": \"ck_field_1192946_company\",\n \"key\": \"company\",\n \"label\": \"Company\"\n }\n ],\n \"pagination\": {...}\n}\n\nCreate Custom Field\nPOST /kit/v4/custom_fields\nContent-Type: application/json\n\n{\n \"label\": \"Company\"\n}\n\nUpdate Custom Field\nPUT /kit/v4/custom_fields/{id}\nContent-Type: application/json\n\n{\n \"label\": \"Company Name\"\n}\n\nDelete Custom Field\nDELETE /kit/v4/custom_fields/{id}\n\n\nReturns 204 No Content on success.\n\nPurchases\nList Purchases\nGET /kit/v4/purchases\n\n\nQuery parameters: per_page, after, before, include_total_count\n\nEmail Templates\nList Email Templates\nGET /kit/v4/email_templates\n\n\nResponse:\n\n{\n \"email_templates\": [\n {\n \"id\": 4956167,\n \"name\": \"Text only\",\n \"is_default\": true,\n \"category\": \"Classic\"\n }\n ],\n \"pagination\": {...}\n}\n\nWebhooks\nList Webhooks\nGET /kit/v4/webhooks\n\nCreate Webhook\nPOST /kit/v4/webhooks\nContent-Type: application/json\n\n{\n \"target_url\": \"https://example.com/webhook\",\n \"event\": {\"name\": \"subscriber.subscriber_activate\"}\n}\n\n\nResponse:\n\n{\n \"webhook\": {\n \"id\": 5291560,\n \"account_id\": 2596262,\n \"event\": {\n \"name\": \"subscriber_activate\",\n \"initiator_value\": null\n },\n \"target_url\": \"https://example.com/webhook\"\n }\n}\n\nDelete Webhook\nDELETE /kit/v4/webhooks/{id}\n\n\nReturns 204 No Content on success.\n\nPagination\n\nKit uses cursor-based pagination. Use after and before query parameters with cursor values from the response.\n\nGET /kit/v4/subscribers?per_page=100&after=WzE0OV0=\n\n\nResponse includes pagination info:\n\n{\n \"subscribers\": [...],\n \"pagination\": {\n \"has_previous_page\": false,\n \"has_next_page\": true,\n \"start_cursor\": \"WzE0OV0=\",\n \"end_cursor\": \"WzI0OV0=\",\n \"per_page\": 100\n }\n}\n\nCode Examples\nJavaScript\nconst response = await fetch(\n 'https://gateway.maton.ai/kit/v4/subscribers?per_page=10',\n {\n headers: {\n 'Authorization': `Bearer ${process.env.MATON_API_KEY}`\n }\n }\n);\nconst data = await response.json();\n\nPython\nimport os\nimport requests\n\nresponse = requests.get(\n 'https://gateway.maton.ai/kit/v4/subscribers',\n headers={'Authorization': f'Bearer {os.environ[\"MATON_API_KEY\"]}'},\n params={'per_page': 10}\n)\ndata = response.json()\n\nNotes\nKit API uses V4 (V3 is deprecated)\nSubscriber IDs are integers\nCustom field keys are auto-generated from labels\nBulk operations (>100 items) are processed asynchronously\nDelete operations return 204 No Content with empty body\nIMPORTANT: When using curl commands, use curl -g when URLs contain brackets to disable glob parsing\nIMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments\nError Handling\nStatus\tMeaning\n400\tMissing Kit connection\n401\tInvalid or missing Maton API key\n403\tInsufficient permissions (check OAuth scopes)\n404\tResource not found\n429\tRate limited\n4xx/5xx\tPassthrough error from Kit API\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\nEnsure your URL path starts with kit. For example:\nCorrect: https://gateway.maton.ai/kit/v4/subscribers\nIncorrect: https://gateway.maton.ai/v4/subscribers\nResources\nKit API Overview\nKit API Subscribers\nKit API Tags\nKit API Forms\nMaton Community\nMaton Support" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/byungkyu/kit", "publisherUrl": "https://clawhub.ai/byungkyu/kit", "owner": "byungkyu", "version": "1.0.2", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/kit", "downloadUrl": "https://openagent3.xyz/downloads/kit", "agentUrl": "https://openagent3.xyz/skills/kit/agent", "manifestUrl": "https://openagent3.xyz/skills/kit/agent.json", "briefUrl": "https://openagent3.xyz/skills/kit/agent.md" } }