Metadata-Version: 2.4
Name: midbound-cloud
Version: 0.0.0.dev0
Summary: Official Midbound Cloud SDK for Python
Project-URL: Homepage, https://midbound.cloud
Project-URL: Documentation, https://midbound.cloud/docs
Project-URL: Repository, https://github.com/midbound/midbound-monorepo
Project-URL: Issues, https://github.com/midbound/midbound-monorepo/issues
Author-email: Midbound <support@midbound.com>
License-Expression: MIT
Keywords: api,b2b,enrichment,midbound,sdk,visitor-identification
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: httpx>=0.25.0
Requires-Dist: pydantic>=2.0.0
Description-Content-Type: text/markdown

# midbound-cloud

Official Midbound Cloud SDK for Python.

## Installation

```bash
pip install midbound-cloud
```

## Usage

```python
from midbound_cloud import Midbound

client = Midbound(api_key="your-api-key")

# Enrich a person by LinkedIn URL
result = client.enrich.person(linkedin_url="https://linkedin.com/in/example")
print(result)
```

## Webhook Verification

```python
from midbound_cloud import webhooks

# Verify a webhook signature
is_valid = webhooks.verify_signature(
    payload=request.body,
    signature=request.headers["x-midbound-signature"],
    secret=os.environ["WEBHOOK_SECRET"]
)

# Or construct a typed event
event = webhooks.construct_event(
    payload=request.body,
    signature=request.headers["x-midbound-signature"],
    secret=os.environ["WEBHOOK_SECRET"]
)
print(event["type"])  # e.g., "identity.resolved"
```

## Documentation

Full documentation available at [midbound.cloud/docs](https://midbound.cloud/docs).
