augint-tools

Augmenting Integrations Tools

Secrets

Push secrets from .env to GH Actions.

Here is a draft for a README.md section that provides a general overview of the LeadmoApiV1 class, its capabilities, and usage examples:

LeadmoApiV1 Class

The LeadmoApiV1 class is a Python client designed to facilitate interactions with the Lead Momentum API. This client provides an easy-to-use interface for managing contacts and appointments within the Lead Momentum platform. It abstracts away the complexities of making HTTP requests and handling authentication, allowing developers to focus on their application's core functionality.

Capabilities

The LeadmoApiV1 class offers the following capabilities:

Contact Management

• Create Contact: Add a new contact to your Lead Momentum account.
• Lookup Contact: Retrieve contact details using contact identifiers.
• Update Contact: Modify existing contact information, such as address and phone number.
• Delete Contact: Remove a contact from your account.
• Get Contact by ID: Fetch detailed information about a contact using their unique identifier.

Appointment Management

• Get Available Appointment Slots: Retrieve available time slots for scheduling appointments.
• Create Appointment: Schedule a new appointment using available slots.
• Get Appointment by ID: Retrieve detailed information about a specific appointment.
• Update Appointment: Change the details of an existing appointment.
• Update Appointment Status: Modify the status of an appointment (e.g., confirmed, canceled).
• Delete Appointment: Cancel and remove an appointment from the schedule.

Usage

Initialization

To use the LeadmoApiV1 client, instantiate it with your API key:

from augint_tools.leadmo_api.v1.client import LeadmoApiV1

# Initialize the client
api_key = "your_api_key_here"
leadmo = LeadmoApiV1(api_key=api_key)

Alternatively, you can set the API key as an environment variable and initialize the client without passing the key explicitly:

from augint_tools.leadmo_api.v1.client import LeadmoApiV1
os.environ["LEADMO_BEARER_TOKEN"] = "your_api_key_here"
# Initialize the client
leadmo = LeadmoApiV1()

Examples

Creating a Contact

# Define contact details
contact_data = {
    "first_name": "John",
    "last_name": "Doe",
    "email": "[e-mail]",
    "phone": "[phone]"
}

# Create the contact
response = leadmo.create_contact(**contact_data)
print(response)

Scheduling an Appointment

# Get available appointment slots
slots_response = leadmo.get_available_appointment_slots(calendar_id="your_calendar_id", timezone="US/Pacific")
next_slot = list(slots_response.values())[0]["slots"][0]

# Create an appointment
appointment_response = leadmo.create_appointment(
    phone=contact_data.get("phone"),
    calendar_id="your_calendar_id",
    selected_slot=next_slot,
    selected_timezone="US/Pacific"
)
print(appointment_response)

Updating Contact Information

# Update the contact's address
update_response = leadmo.update_contact(contact_id=contact_id, address1="1234 Main St.")
print(update_response)

Deleting an Appointment

# Delete the appointment
leadmo.delete_appointment(appointment_id=appointment_id)

Conclusion

The LeadmoApiV1 class streamlines the process of integrating with the Lead Momentum API, providing a simple and efficient way to manage contacts and appointments programmatically. By utilizing this client, developers can focus on building robust applications while leveraging the powerful features offered by the Lead Momentum platform.

examples as needed for your project's documentation!