Skip to main content
skill CX Codex

setting-up-a-custom-rest-source — Claude Code skill: setup guide

setting-up-a-custom-rest-source — a skill for Claude Code and Codex that links arbitrary REST APIs to the PostHog data warehouse using a JSON manifest. Activates when importing custom endpoints without native connectors.

no license 199 installs ★ 101 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add PostHog/ai-plugin --skill setting-up-a-custom-rest-source -a claude-code
Open on GitHub

What setting-up-a-custom-rest-source does

This skill authors a RESTAPIConfig manifest for PostHog custom data warehouse sources without requiring bespoke backend scripts. It first runs external-data-sources-wizard to confirm that PostHog lacks an out-of-the-box connector for the targeted API. When no native connector exists, the skill builds the configuration covering auth modes, pagination strategies, JSONPath record extraction, and incremental update cursors.

The workflow validates credentials and resource schemas with external-data-sources-db-schema, then samples live rows via external-data-sources-preview-resource to confirm field mappings. Authentication secrets are never placed inside manifest_json: keys such as auth_token or auth_api_key are submitted in isolated payload fields and redacted by the platform.

Custom sources operate under beta limits: each manifest can specify at most 50 resources, with a ceiling of 5 custom sources per project. Drafting manifests automatically with external-data-sources-draft-custom-manifest requires the PostHog AI builder enabled for the organization.

What it helps with

  • Ingest unsupported REST APIs into PostHog tables without Python glue code
  • Generate valid RESTAPIConfig JSON structures from API documentation
  • Test pagination and cursor paths against live records prior to source creation
  • Configure incremental extraction cursors for custom API tables

Example prompts for the agent

  • Import our internal billing API into PostHog data warehouse using its docs
  • Draft a custom REST source manifest for this third-party endpoint
  • Validate this RESTAPIConfig manifest and sample live rows before creating the source

How to install setting-up-a-custom-rest-source

1Skills CLI (Vercel)

npx skills add PostHog/ai-plugin --skill setting-up-a-custom-rest-source -a claude-code

2Manually: put the files in place

~/.claude/skills/setting-up-a-custom-rest-source/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/setting-up-a-custom-rest-source/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about setting-up-a-custom-rest-source

How to install setting-up-a-custom-rest-source in Claude Code?

Run npx skills add PostHog/ai-plugin --skill setting-up-a-custom-rest-source -a claude-code.

What does setting-up-a-custom-rest-source do?

It drafts, validates, and samples a JSON manifest to sync arbitrary REST APIs into PostHog warehouse tables.

What are the constraints on custom REST sources?

The feature is in beta and caps usage at 50 resources per manifest and 5 custom sources per project.

Similar skills

All skills for Data and databases →

From the same set82

The whole set →
managing-reminders managing-reminders is a Claude Code skill that creates and manages private PostHog reminders with one-time or repeating schedules. It can nudge you about a task or resource. CX Codex +1 202installs signals-scout-apm signals-scout-apm watches OpenTelemetry traces in PostHog for error-rate and latency shifts per service, new error signatures and traffic drops, and files a report only on a confirmed change. CX Codex +1 202installs exploring-mcp-tool-usage exploring-mcp-tool-usage — a routing skill for PostHog MCP analytics: it offers a menu of questions about tool calls, then hands you to the query that answers it. CX Codex +1 200installs checking-deploy-timing checking-deploy-timing tells you when a commit or PR reached prod-us or prod-eu by reading PostHog's hidden deploy annotations and matching them against the merge commit on GitHub. CX Codex +1 200installs exploring-ai-failures exploring-ai-failures reads real production traces from PostHog and returns a ranked list of the ways your LLM feature breaks. CX Codex +1 198installs resolving-ingestion-warnings resolving-ingestion-warnings walks through PostHog ingestion warnings: dropped events, rejected person merges, oversized payloads. Use it when event counts look low or identify calls misbehave. CX Codex +1 197installs exploring-scouts exploring-scouts reads the state of PostHog Signals scouts: which ones a project has, how recent runs went, and where their reports ended up. Read-only. CX Codex +1 197installs debugging-surveys debugging-surveys investigates why PostHog Surveys fail to appear or record complete answers. Useful for support cases involving targeting, SDK behavior, and stored responses. CX Codex +1 197installs

Project sponsors

Companies that keep this analytics open