Python SDK

pip install buena-sdk

import buena_sdk
from buena_sdk.rest import ApiException
from buena_sdk.api.default_api import DefaultApi

# Initialize the client
configuration = buena_sdk.Configuration(
    host="https://api.buena.ai/api/v2"
)
configuration.api_key['ApiKeyAuth'] = 'your-api-key'

# Create API client
with buena_sdk.ApiClient(configuration) as api_client:
    api_instance = DefaultApi(api_client)

    try:
        # List leads
        leads = api_instance.list_leads()
        print(leads)

        # Create a new lead
        lead_request = buena_sdk.CreateLeadRequest(
            first_name="John",
            last_name="Doe",
            email="john@example.com",
            company="Example Corp"
        )
        new_lead = api_instance.create_lead(lead_request)
        print(f"Created lead: {new_lead}")

    except ApiException as e:
        print(f"Exception when calling API: {e}")

import buena_sdk

# Basic configuration
configuration = buena_sdk.Configuration(
    host='https://api.buena.ai/api/v2',  # API base URL
)

# Set API key
configuration.api_key['ApiKeyAuth'] = 'your-api-key'

# Optional: Configure timeouts and retries
configuration.connection_pool_maxsize = 10
configuration.proxy = None  # Set proxy if needed
configuration.verify_ssl = True  # SSL verification
configuration.ssl_ca_cert = None  # Custom CA certificate

import asyncio
import buena_sdk
from buena_sdk.api.default_api import DefaultApi
from buena_sdk.rest import ApiException

async def main():
    configuration = buena_sdk.Configuration(
        host="https://api.buena.ai/api/v2"
    )
    configuration.api_key['ApiKeyAuth'] = 'your-api-key'

    async with buena_sdk.ApiClient(configuration) as api_client:
        api_instance = DefaultApi(api_client)

        try:
            # List leads asynchronously
            leads = await api_instance.list_leads()
            print(leads)

            # Create lead asynchronously
            lead_request = buena_sdk.CreateLeadRequest(
                first_name="Jane",
                last_name="Smith",
                email="jane@example.com"
            )
            new_lead = await api_instance.create_lead(lead_request)
            print(f"Created lead: {new_lead}")

        except ApiException as e:
            print(f"Exception when calling API: {e}")

# Run async function
asyncio.run(main())

from buena_sdk.rest import ApiException

try:
    leads = api_instance.list_leads()
except ApiException as e:
    print(f"Exception when calling DefaultApi->list_leads: {e}")

    # Handle specific error codes
    if e.status == 401:
        print('Invalid API key - check your authentication')
    elif e.status == 429:
        print('Rate limit exceeded - please retry later')
    elif e.status == 500:
        print('Server error - please contact support')
    else:
        print(f'API error {e.status}: {e.reason}')

except Exception as e:
    print(f"Unexpected error: {e}")

import buena_sdk

# Create a lead object
lead_request = buena_sdk.CreateLeadRequest(
    first_name="John",
    last_name="Doe",
    email="john@example.com",
    company="Example Corp",
    phone="+1234567890",
    linkedin_url="https://linkedin.com/in/johndoe"
)

# Access lead properties
print(f"Creating lead: {lead_request.first_name} {lead_request.last_name}")
print(f"Email: {lead_request.email}")