airbyte-agent-klaviyo 0.1.1__tar.gz

airbyte_agent_klaviyo-0.1.1/.gitignore

@@ -0,0 +1,29 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+.env
+configured_connectors.yaml

airbyte_agent_klaviyo-0.1.1/AUTH.md

@@ -0,0 +1,99 @@
+# Klaviyo authentication and configuration
+
+This page documents the authentication and configuration options for the Klaviyo agent connector.
+
+## Authentication
+
+### Open source execution
+
+In open source mode, you provide API credentials directly to the connector.
+
+#### OAuth
+This authentication method isn't available for this connector.
+
+#### Token
+
+`credentials` fields you need:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `api_key` | `str` | Yes | Your Klaviyo private API key |
+
+Example request:
+
+```python
+from airbyte_agent_klaviyo import KlaviyoConnector
+from airbyte_agent_klaviyo.models import KlaviyoAuthConfig
+
+connector = KlaviyoConnector(
+    auth_config=KlaviyoAuthConfig(
+        api_key="<Your Klaviyo private API key>"
+    )
+)
+```
+
+### Hosted execution
+
+In hosted mode, you first create a connector via the Airbyte API (providing your OAuth or Token credentials), then execute operations using either the Python SDK or API. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+#### OAuth
+This authentication method isn't available for this connector.
+
+#### Token
+Create a connector with Token credentials.
+
+
+`credentials` fields you need:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `api_key` | `str` | Yes | Your Klaviyo private API key |
+
+Example request:
+
+
+```bash
+curl -X POST "https://api.airbyte.ai/v1/integrations/connectors" \
+  -H "Authorization: Bearer <SCOPED_TOKEN>" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "external_user_id": "<EXTERNAL_USER_ID>",
+    "connector_type": "Klaviyo",
+    "name": "My Klaviyo Connector",
+    "credentials": {
+      "api_key": "<Your Klaviyo private API key>"
+    }
+  }'
+```
+
+#### Execution
+
+After creating the connector, execute operations using either the Python SDK or API.
+
+**Python SDK**
+
+```python
+from airbyte_agent_klaviyo import KlaviyoConnector
+
+connector = KlaviyoConnector(
+    external_user_id="<your_external_user_id>",
+    airbyte_client_id="<your-client-id>",
+    airbyte_client_secret="<your-client-secret>"
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@KlaviyoConnector.tool_utils
+async def klaviyo_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+**API**
+
+```bash
+curl -X POST 'https://api.airbyte.ai/api/v1/connectors/sources/<connector_id>/execute' \
+  -H 'Authorization: Bearer <SCOPED_TOKEN>' \
+  -H 'Content-Type: application/json' \
+  -d '{"entity": "<entity>", "action": "<action>", "params": {}}'
+```
+
+

airbyte_agent_klaviyo-0.1.1/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Klaviyo changelog
+
+## [0.1.1] - 2026-01-30
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: a3729d85
+- SDK version: 0.1.0
+
+## [0.1.0] - 2026-01-30
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 041914fa
+- SDK version: 0.1.0

airbyte_agent_klaviyo-0.1.1/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: airbyte-agent-klaviyo
+Version: 0.1.1
+Summary: Airbyte Klaviyo Connector for AI platforms
+Project-URL: Homepage, https://github.com/airbytehq/airbyte-agent-connectors
+Project-URL: Documentation, https://docs.airbyte.com/ai-agents/
+Project-URL: Repository, https://github.com/airbytehq/airbyte-agent-connectors
+Project-URL: Issues, https://github.com/airbytehq/airbyte-agent-connectors/issues
+Author-email: Airbyte <contact@airbyte.io>
+License: Elastic-2.0
+Keywords: agent,ai,airbyte,api,connector,data-integration,klaviyo,llm,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: jsonpath-ng>=1.6.1
+Requires-Dist: jsonref>=1.1.0
+Requires-Dist: opentelemetry-api>=1.37.0
+Requires-Dist: opentelemetry-sdk>=1.37.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: segment-analytics-python>=2.2.0
+Description-Content-Type: text/markdown
+
+# Klaviyo agent connector
+
+Klaviyo is a marketing automation platform that helps businesses build customer relationships
+through personalized email, SMS, and push notifications. This connector provides access to
+Klaviyo's core entities including profiles, lists, campaigns, events, metrics, flows, and
+email templates for marketing analytics and customer engagement insights.
+
+
+## Example questions
+
+The Klaviyo connector is optimized to handle prompts like these.
+
+- List all profiles in my Klaviyo account
+- Get profile details for a specific contact
+- Show me all email lists
+- Get details for a specific email list
+- What campaigns have been created?
+- Get details for a specific campaign
+- Show me all email campaigns
+- List all events for tracking customer actions
+- Show me all metrics (event types)
+- Get details for a specific metric
+- What automated flows are configured?
+- Get details for a specific flow
+- List all email templates
+- Get details for a specific email template
+
+## Unsupported questions
+
+The Klaviyo connector isn't currently able to handle prompts like these.
+
+- Create a new profile
+- Update a profile's email address
+- Delete a list
+- Send an email campaign
+- Add a profile to a list
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-klaviyo
+```
+
+## Usage
+
+Connectors can run in open source or hosted mode.
+
+### Open source
+
+In open source mode, you provide API credentials directly to the connector.
+
+```python
+from airbyte_agent_klaviyo import KlaviyoConnector
+from airbyte_agent_klaviyo.models import KlaviyoAuthConfig
+
+connector = KlaviyoConnector(
+    auth_config=KlaviyoAuthConfig(
+        api_key="<Your Klaviyo private API key>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@KlaviyoConnector.tool_utils
+async def klaviyo_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+### Hosted
+
+In hosted mode, API credentials are stored securely in Airbyte Cloud. You provide your Airbyte credentials instead. 
+
+This example assumes you've already authenticated your connector with Airbyte. See [Authentication](AUTH.md) to learn more about authenticating. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+```python
+from airbyte_agent_klaviyo import KlaviyoConnector
+
+connector = KlaviyoConnector(
+    external_user_id="<your_external_user_id>",
+    airbyte_client_id="<your-client-id>",
+    airbyte_client_secret="<your-client-secret>"
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@KlaviyoConnector.tool_utils
+async def klaviyo_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+## Full documentation
+
+### Entities and actions
+
+This connector supports the following entities and actions. For more details, see this connector's [full reference documentation](REFERENCE.md).
+
+| Entity | Actions |
+|--------|---------|
+| Profiles | [List](./REFERENCE.md#profiles-list), [Get](./REFERENCE.md#profiles-get) |
+| Lists | [List](./REFERENCE.md#lists-list), [Get](./REFERENCE.md#lists-get) |
+| Campaigns | [List](./REFERENCE.md#campaigns-list), [Get](./REFERENCE.md#campaigns-get) |
+| Events | [List](./REFERENCE.md#events-list) |
+| Metrics | [List](./REFERENCE.md#metrics-list), [Get](./REFERENCE.md#metrics-get) |
+| Flows | [List](./REFERENCE.md#flows-list), [Get](./REFERENCE.md#flows-get) |
+| Email Templates | [List](./REFERENCE.md#email-templates-list), [Get](./REFERENCE.md#email-templates-get) |
+
+
+### Authentication and configuration
+
+For all authentication and configuration options, see the connector's [authentication documentation](AUTH.md).
+
+### Klaviyo API docs
+
+See the official [Klaviyo API reference](https://developers.klaviyo.com/en/reference/api_overview).
+
+## Version information
+
+- **Package version:** 0.1.1
+- **Connector version:** 1.0.0
+- **Generated with Connector SDK commit SHA:** e4eb233f8dd57ad9bc825064625222a988db2cc6
+- **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/klaviyo/CHANGELOG.md)

airbyte_agent_klaviyo-0.1.1/README.md

@@ -0,0 +1,119 @@
+# Klaviyo agent connector
+
+Klaviyo is a marketing automation platform that helps businesses build customer relationships
+through personalized email, SMS, and push notifications. This connector provides access to
+Klaviyo's core entities including profiles, lists, campaigns, events, metrics, flows, and
+email templates for marketing analytics and customer engagement insights.
+
+
+## Example questions
+
+The Klaviyo connector is optimized to handle prompts like these.
+
+- List all profiles in my Klaviyo account
+- Get profile details for a specific contact
+- Show me all email lists
+- Get details for a specific email list
+- What campaigns have been created?
+- Get details for a specific campaign
+- Show me all email campaigns
+- List all events for tracking customer actions
+- Show me all metrics (event types)
+- Get details for a specific metric
+- What automated flows are configured?
+- Get details for a specific flow
+- List all email templates
+- Get details for a specific email template
+
+## Unsupported questions
+
+The Klaviyo connector isn't currently able to handle prompts like these.
+
+- Create a new profile
+- Update a profile's email address
+- Delete a list
+- Send an email campaign
+- Add a profile to a list
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-klaviyo
+```
+
+## Usage
+
+Connectors can run in open source or hosted mode.
+
+### Open source
+
+In open source mode, you provide API credentials directly to the connector.
+
+```python
+from airbyte_agent_klaviyo import KlaviyoConnector
+from airbyte_agent_klaviyo.models import KlaviyoAuthConfig
+
+connector = KlaviyoConnector(
+    auth_config=KlaviyoAuthConfig(
+        api_key="<Your Klaviyo private API key>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@KlaviyoConnector.tool_utils
+async def klaviyo_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+### Hosted
+
+In hosted mode, API credentials are stored securely in Airbyte Cloud. You provide your Airbyte credentials instead. 
+
+This example assumes you've already authenticated your connector with Airbyte. See [Authentication](AUTH.md) to learn more about authenticating. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+```python
+from airbyte_agent_klaviyo import KlaviyoConnector
+
+connector = KlaviyoConnector(
+    external_user_id="<your_external_user_id>",
+    airbyte_client_id="<your-client-id>",
+    airbyte_client_secret="<your-client-secret>"
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@KlaviyoConnector.tool_utils
+async def klaviyo_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+## Full documentation
+
+### Entities and actions
+
+This connector supports the following entities and actions. For more details, see this connector's [full reference documentation](REFERENCE.md).
+
+| Entity | Actions |
+|--------|---------|
+| Profiles | [List](./REFERENCE.md#profiles-list), [Get](./REFERENCE.md#profiles-get) |
+| Lists | [List](./REFERENCE.md#lists-list), [Get](./REFERENCE.md#lists-get) |
+| Campaigns | [List](./REFERENCE.md#campaigns-list), [Get](./REFERENCE.md#campaigns-get) |
+| Events | [List](./REFERENCE.md#events-list) |
+| Metrics | [List](./REFERENCE.md#metrics-list), [Get](./REFERENCE.md#metrics-get) |
+| Flows | [List](./REFERENCE.md#flows-list), [Get](./REFERENCE.md#flows-get) |
+| Email Templates | [List](./REFERENCE.md#email-templates-list), [Get](./REFERENCE.md#email-templates-get) |
+
+
+### Authentication and configuration
+
+For all authentication and configuration options, see the connector's [authentication documentation](AUTH.md).
+
+### Klaviyo API docs
+
+See the official [Klaviyo API reference](https://developers.klaviyo.com/en/reference/api_overview).
+
+## Version information
+
+- **Package version:** 0.1.1
+- **Connector version:** 1.0.0
+- **Generated with Connector SDK commit SHA:** e4eb233f8dd57ad9bc825064625222a988db2cc6
+- **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/klaviyo/CHANGELOG.md)