klaviyo-common-errors

Featured

Diagnose and fix common Klaviyo API errors and exceptions. Use when encountering Klaviyo 4xx/5xx errors, debugging failed requests, or troubleshooting SDK integration issues. Trigger with phrases like "klaviyo error", "fix klaviyo", "klaviyo not working", "debug klaviyo", "klaviyo 400", "klaviyo 429".

AI & Automation 2,926 stars 433 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Klaviyo Common Errors ## Overview Quick reference for the most common Klaviyo API errors with real error payloads, root causes, and solutions. ## Prerequisites - `klaviyo-api` SDK installed - API credentials configured - Access to application logs ## Instructions ### Step 1: Identify the Error Klaviyo returns JSON:API error responses. Extract the status code and error detail: ```typescript try { await profilesApi.createProfile(payload); } catch (error: any) { console.error('Status:', error.status); console.error('Errors:', JSON.stringify(error.body?.errors, null, 2)); // error.body.errors[] has: { id, code, title, detail, source } } ``` ### Step 2: Match and Fix --- ### 400 -- Bad Request (Validation Error) **Actual Klaviyo response:** ```json { "errors": [{ "id": "abc-123", "code": "invalid", "title": "Invalid input.", "detail": "The email field is required.", "source": { "pointer": "/data/attributes/email" } }] } ``` **Common causes:** - Missing required field (email, metric name, list name) - Invalid phone number format (must be E.164: `+15551234567`) - Invalid filter syntax in query params - Wrong `type` value in JSON:API payload - Sending `snake_case` instead of `camelCase` (SDK uses camelCase) **Fix:** ```typescript // Wrong: snake_case { first_name: 'Jane', phone_number: '+155...' } // Right: camelCase (SDK convention) { firstName: 'Jane', phoneNumber: '+15551234567' } ``` --- ### 401 -- Unauthorized **Actual response...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
1 years ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category