clay-hello-world

jeremylongshore's avatarfrom jeremylongshore

Create a minimal working Clay example.Use when starting a new Clay integration, testing your setup,or learning basic Clay API patterns.Trigger with phrases like "clay hello world", "clay example","clay quick start", "simple clay code".

⭐939stars🔀114forks📁View on GitHub🕐Updated Jan 11, 2026
[API Helpers]

When & Why to Use This Skill

This Claude skill streamlines the onboarding process for Clay integrations by generating minimal, production-ready boilerplate code. It enables developers to instantly verify API connectivity, test environment configurations, and understand core Clay API patterns through clean TypeScript and Python examples, significantly reducing the time from setup to first successful request.

Use Cases

  • New Project Initialization: Rapidly generate the foundational code required to initialize the Clay SDK and authenticate with an API key in a new development environment.
  • Connectivity & Auth Verification: Use the minimal example to troubleshoot and confirm that API credentials and network settings are correctly configured before building complex logic.
  • Developer Education: Provide a clear, executable reference for developers learning the basic syntax, client structure, and error-handling patterns of the Clay API.
nameclay-hello-world
description|
allowed-toolsRead, Write, Edit
version1.0.0
licenseMIT
authorJeremy Longshore <jeremy@intentsolutions.io>

Clay Hello World

Overview

Minimal working example demonstrating core Clay functionality.

Prerequisites

  • Completed clay-install-auth setup
  • Valid API credentials configured
  • Development environment ready

Instructions

Step 1: Create Entry File

Create a new file for your hello world example.

Step 2: Import and Initialize Client

import { ClayClient } from '@clay/sdk';

const client = new ClayClient({
  apiKey: process.env.CLAY_API_KEY,
});

Step 3: Make Your First API Call

async function main() {
  // Your first API call here
}

main().catch(console.error);

Output

  • Working code file with Clay client initialization
  • Successful API response confirming connection
  • Console output showing:
Success! Your Clay connection is working.

Error Handling

Error Cause Solution
Import Error SDK not installed Verify with npm list or pip show
Auth Error Invalid credentials Check environment variable is set
Timeout Network issues Increase timeout or check connectivity
Rate Limit Too many requests Wait and retry with exponential backoff

Examples

TypeScript Example

import { ClayClient } from '@clay/sdk';

const client = new ClayClient({
  apiKey: process.env.CLAY_API_KEY,
});

async function main() {
  // Your first API call here
}

main().catch(console.error);

Python Example

from clay import ClayClient

client = ClayClient()

# Your first API call here

Resources

Next Steps

Proceed to clay-local-dev-loop for development workflow setup.