airbyte-agent-sendgrid 0.1.0__tar.gz

airbyte_agent_sendgrid-0.1.0/.gitignore

@@ -0,0 +1,34 @@
+# 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
+
+# Claude Code development symlink
+# Contributors: Create this symlink locally for skill testing
+# mkdir -p .claude/skills && ln -s ../../skills/airbyte-agent-connectors .claude/skills/airbyte-agent-connectors
+.claude/skills/airbyte-agent-connectors

airbyte_agent_sendgrid-0.1.0/AUTH.md

@@ -0,0 +1,116 @@
+# Sendgrid authentication
+
+This page documents the authentication and configuration options for the Sendgrid 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 SendGrid API key (generated at https://app.sendgrid.com/settings/api_keys) |
+
+Example request:
+
+```python
+from airbyte_agent_sendgrid import SendgridConnector
+from airbyte_agent_sendgrid.models import SendgridAuthConfig
+
+connector = SendgridConnector(
+    auth_config=SendgridAuthConfig(
+        api_key="<Your SendGrid API key (generated at https://app.sendgrid.com/settings/api_keys)>"
+    )
+)
+```
+
+### 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.
+
+#### Bring your own OAuth flow
+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 SendGrid API key (generated at https://app.sendgrid.com/settings/api_keys) |
+
+`replication_config` fields you need:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `start_date` | `str (date-time)` | Yes | UTC date and time in the format 2017-01-25T00:00:00Z. Any data before this date will not be replicated. |
+
+Example request:
+
+
+```bash
+curl -X POST "https://api.airbyte.ai/api/v1/integrations/connectors" \
+  -H "Authorization: Bearer <YOUR_BEARER_TOKEN>" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "customer_name": "<CUSTOMER_NAME>",
+    "connector_type": "Sendgrid",
+    "name": "My Sendgrid Connector",
+    "credentials": {
+      "api_key": "<Your SendGrid API key (generated at https://app.sendgrid.com/settings/api_keys)>"
+    },
+    "replication_config": {
+      "start_date": "<UTC date and time in the format 2017-01-25T00:00:00Z. Any data before this date will not be replicated.>"
+    }
+  }'
+```
+
+#### Execution
+
+After creating the connector, execute operations using either the Python SDK or API.
+If your Airbyte client can access multiple organizations, include `organization_id` in `AirbyteAuthConfig` and `X-Organization-Id` in raw API calls.
+
+**Python SDK**
+
+```python
+from airbyte_agent_sendgrid import SendgridConnector, AirbyteAuthConfig
+
+connector = SendgridConnector(
+    auth_config=AirbyteAuthConfig(
+        customer_name="<your_customer_name>",
+        organization_id="<your_organization_id>",  # Optional for multi-org clients
+        airbyte_client_id="<your-client-id>",
+        airbyte_client_secret="<your-client-secret>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@SendgridConnector.tool_utils
+async def sendgrid_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/integrations/connectors/<connector_id>/execute' \
+  -H 'Authorization: Bearer <YOUR_BEARER_TOKEN>' \
+  -H 'X-Organization-Id: <YOUR_ORGANIZATION_ID>' \
+  -H 'Content-Type: application/json' \
+  -d '{"entity": "<entity>", "action": "<action>", "params": {}}'
+```
+
+

airbyte_agent_sendgrid-0.1.0/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Sendgrid changelog
+
+## [0.1.0] - 2026-02-25
+- Updated connector definition (YAML version 1.0.1)
+- Source commit: bcb024e5
+- SDK version: 0.1.0

airbyte_agent_sendgrid-0.1.0/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: airbyte-agent-sendgrid
+Version: 0.1.0
+Summary: Airbyte Sendgrid 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,llm,mcp,sendgrid
+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
+
+# Sendgrid
+
+The Sendgrid agent connector is a Python package that equips AI agents to interact with Sendgrid through strongly typed, well-documented tools. It's ready to use directly in your Python app, in an agent framework, or exposed through an MCP.
+
+Connector for the Twilio SendGrid v3 API. Provides read access to marketing campaigns, contacts, lists, segments, single sends, transactional templates, and suppression management (bounces, blocks, spam reports, invalid emails, global suppressions, suppression groups, and suppression group members).
+
+
+## Example questions
+
+The Sendgrid connector is optimized to handle prompts like these.
+
+- List all marketing contacts
+- Get the details of a specific contact
+- Show me all marketing lists
+- List all transactional templates
+- Show all single sends
+- List all bounced emails
+- Show all blocked email addresses
+- List all spam reports
+- Show all suppression groups
+- How many contacts are in each marketing list?
+- Which single sends were scheduled in the last month?
+- What are the most common bounce reasons?
+- Show me contacts created in the last 7 days
+
+## Unsupported questions
+
+The Sendgrid connector isn't currently able to handle prompts like these.
+
+- Send an email
+- Create a new contact
+- Delete a bounce record
+- Update a marketing list
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-sendgrid
+```
+
+## 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_sendgrid import SendgridConnector
+from airbyte_agent_sendgrid.models import SendgridAuthConfig
+
+connector = SendgridConnector(
+    auth_config=SendgridAuthConfig(
+        api_key="<Your SendGrid API key (generated at https://app.sendgrid.com/settings/api_keys)>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@SendgridConnector.tool_utils
+async def sendgrid_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. 
+If your Airbyte client can access multiple organizations, also set `organization_id`.
+
+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_sendgrid import SendgridConnector, AirbyteAuthConfig
+
+connector = SendgridConnector(
+    auth_config=AirbyteAuthConfig(
+        customer_name="<your_customer_name>",
+        organization_id="<your_organization_id>",  # Optional for multi-org clients
+        airbyte_client_id="<your-client-id>",
+        airbyte_client_secret="<your-client-secret>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@SendgridConnector.tool_utils
+async def sendgrid_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 |
+|--------|---------|
+| Contacts | [List](./REFERENCE.md#contacts-list), [Get](./REFERENCE.md#contacts-get), [Search](./REFERENCE.md#contacts-search) |
+| Lists | [List](./REFERENCE.md#lists-list), [Get](./REFERENCE.md#lists-get), [Search](./REFERENCE.md#lists-search) |
+| Segments | [List](./REFERENCE.md#segments-list), [Get](./REFERENCE.md#segments-get), [Search](./REFERENCE.md#segments-search) |
+| Campaigns | [List](./REFERENCE.md#campaigns-list), [Search](./REFERENCE.md#campaigns-search) |
+| Singlesends | [List](./REFERENCE.md#singlesends-list), [Get](./REFERENCE.md#singlesends-get), [Search](./REFERENCE.md#singlesends-search) |
+| Templates | [List](./REFERENCE.md#templates-list), [Get](./REFERENCE.md#templates-get), [Search](./REFERENCE.md#templates-search) |
+| Singlesend Stats | [List](./REFERENCE.md#singlesend-stats-list), [Search](./REFERENCE.md#singlesend-stats-search) |
+| Bounces | [List](./REFERENCE.md#bounces-list), [Search](./REFERENCE.md#bounces-search) |
+| Blocks | [List](./REFERENCE.md#blocks-list), [Search](./REFERENCE.md#blocks-search) |
+| Spam Reports | [List](./REFERENCE.md#spam-reports-list) |
+| Invalid Emails | [List](./REFERENCE.md#invalid-emails-list), [Search](./REFERENCE.md#invalid-emails-search) |
+| Global Suppressions | [List](./REFERENCE.md#global-suppressions-list), [Search](./REFERENCE.md#global-suppressions-search) |
+| Suppression Groups | [List](./REFERENCE.md#suppression-groups-list), [Get](./REFERENCE.md#suppression-groups-get), [Search](./REFERENCE.md#suppression-groups-search) |
+| Suppression Group Members | [List](./REFERENCE.md#suppression-group-members-list), [Search](./REFERENCE.md#suppression-group-members-search) |
+
+
+### Authentication
+
+For all authentication options, see the connector's [authentication documentation](AUTH.md).
+
+### Sendgrid API docs
+
+See the official [Sendgrid API reference](https://docs.sendgrid.com/api-reference).
+
+## Version information
+
+- **Package version:** 0.1.0
+- **Connector version:** 1.0.1
+- **Generated with Connector SDK commit SHA:** bcb024e51bb63dfea8ecdbc59da0966e25d6ed53
+- **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/sendgrid/CHANGELOG.md)

airbyte_agent_sendgrid-0.1.0/README.md

@@ -0,0 +1,127 @@
+# Sendgrid
+
+The Sendgrid agent connector is a Python package that equips AI agents to interact with Sendgrid through strongly typed, well-documented tools. It's ready to use directly in your Python app, in an agent framework, or exposed through an MCP.
+
+Connector for the Twilio SendGrid v3 API. Provides read access to marketing campaigns, contacts, lists, segments, single sends, transactional templates, and suppression management (bounces, blocks, spam reports, invalid emails, global suppressions, suppression groups, and suppression group members).
+
+
+## Example questions
+
+The Sendgrid connector is optimized to handle prompts like these.
+
+- List all marketing contacts
+- Get the details of a specific contact
+- Show me all marketing lists
+- List all transactional templates
+- Show all single sends
+- List all bounced emails
+- Show all blocked email addresses
+- List all spam reports
+- Show all suppression groups
+- How many contacts are in each marketing list?
+- Which single sends were scheduled in the last month?
+- What are the most common bounce reasons?
+- Show me contacts created in the last 7 days
+
+## Unsupported questions
+
+The Sendgrid connector isn't currently able to handle prompts like these.
+
+- Send an email
+- Create a new contact
+- Delete a bounce record
+- Update a marketing list
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-sendgrid
+```
+
+## 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_sendgrid import SendgridConnector
+from airbyte_agent_sendgrid.models import SendgridAuthConfig
+
+connector = SendgridConnector(
+    auth_config=SendgridAuthConfig(
+        api_key="<Your SendGrid API key (generated at https://app.sendgrid.com/settings/api_keys)>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@SendgridConnector.tool_utils
+async def sendgrid_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. 
+If your Airbyte client can access multiple organizations, also set `organization_id`.
+
+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_sendgrid import SendgridConnector, AirbyteAuthConfig
+
+connector = SendgridConnector(
+    auth_config=AirbyteAuthConfig(
+        customer_name="<your_customer_name>",
+        organization_id="<your_organization_id>",  # Optional for multi-org clients
+        airbyte_client_id="<your-client-id>",
+        airbyte_client_secret="<your-client-secret>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@SendgridConnector.tool_utils
+async def sendgrid_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 |
+|--------|---------|
+| Contacts | [List](./REFERENCE.md#contacts-list), [Get](./REFERENCE.md#contacts-get), [Search](./REFERENCE.md#contacts-search) |
+| Lists | [List](./REFERENCE.md#lists-list), [Get](./REFERENCE.md#lists-get), [Search](./REFERENCE.md#lists-search) |
+| Segments | [List](./REFERENCE.md#segments-list), [Get](./REFERENCE.md#segments-get), [Search](./REFERENCE.md#segments-search) |
+| Campaigns | [List](./REFERENCE.md#campaigns-list), [Search](./REFERENCE.md#campaigns-search) |
+| Singlesends | [List](./REFERENCE.md#singlesends-list), [Get](./REFERENCE.md#singlesends-get), [Search](./REFERENCE.md#singlesends-search) |
+| Templates | [List](./REFERENCE.md#templates-list), [Get](./REFERENCE.md#templates-get), [Search](./REFERENCE.md#templates-search) |
+| Singlesend Stats | [List](./REFERENCE.md#singlesend-stats-list), [Search](./REFERENCE.md#singlesend-stats-search) |
+| Bounces | [List](./REFERENCE.md#bounces-list), [Search](./REFERENCE.md#bounces-search) |
+| Blocks | [List](./REFERENCE.md#blocks-list), [Search](./REFERENCE.md#blocks-search) |
+| Spam Reports | [List](./REFERENCE.md#spam-reports-list) |
+| Invalid Emails | [List](./REFERENCE.md#invalid-emails-list), [Search](./REFERENCE.md#invalid-emails-search) |
+| Global Suppressions | [List](./REFERENCE.md#global-suppressions-list), [Search](./REFERENCE.md#global-suppressions-search) |
+| Suppression Groups | [List](./REFERENCE.md#suppression-groups-list), [Get](./REFERENCE.md#suppression-groups-get), [Search](./REFERENCE.md#suppression-groups-search) |
+| Suppression Group Members | [List](./REFERENCE.md#suppression-group-members-list), [Search](./REFERENCE.md#suppression-group-members-search) |
+
+
+### Authentication
+
+For all authentication options, see the connector's [authentication documentation](AUTH.md).
+
+### Sendgrid API docs
+
+See the official [Sendgrid API reference](https://docs.sendgrid.com/api-reference).
+
+## Version information
+
+- **Package version:** 0.1.0
+- **Connector version:** 1.0.1
+- **Generated with Connector SDK commit SHA:** bcb024e51bb63dfea8ecdbc59da0966e25d6ed53
+- **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/sendgrid/CHANGELOG.md)