affinity-python-sdk

Provide a strongly-typed Python SDK for the Affinity CRM API.

1|Updated Dec 14, 2025
One-click install
npx skills add https://github.com/yaniv-golan/affinity-sdk --skill affinity-python-sdk-yaniv-golan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: affinity-python-sdk
Source: https://github.com/yaniv-golan/affinity-sdk/tree/main/plugins/affinity-sdk/.claude-plugin/skills/affinity-python-sdk
Command: npx skills add https://github.com/yaniv-golan/affinity-sdk --skill affinity-python-sdk-yaniv-golan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a strongly-typed Python interface for interacting with the Affinity CRM API, reducing runtime errors and onboarding friction for developers.

Core Features & Use Cases

  • Typed IDs to ensure type safety across client calls with entities like PersonId and CompanyId.
  • Full support for both synchronous and asynchronous clients, including pagination patterns and error handling.
  • Clear guidance for common automation tasks: data retrieval, list operations, and safe write workflows with explicit user consent.

Quick Start

Install the affinity-sdk and initialize a read-only client to fetch basic data from your Affinity workspace.

Frequently Asked Questions about affinity-python-sdk

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I interact with the Affinity CRM API using Python without runtime type errors?

You can use a strongly-typed Python SDK for the Affinity CRM API to reduce runtime errors and boilerplate. It provides typed IDs like PersonId and CompanyId to ensure type safety across client calls.

Can I use async Python to fetch paginated data from Affinity CRM?

Yes, the Affinity Python SDK supports both synchronous and asynchronous clients. It includes built-in pagination patterns and error handling to enable productive, non-blocking data retrieval.

How do I safely write data to Affinity CRM using a Python SDK?

Safe writes to Affinity CRM require explicit user consent and write permissions enforced by the SDK. This ensures secure automation workflows for list operations and data updates.

What is the best way to automate Affinity CRM data retrieval in Python?

Automating Affinity CRM data retrieval is best handled by initializing a strongly-typed Python SDK client. This approach minimizes onboarding friction and provides robust error handling for fetching workspace data.

Do I need specific Python libraries to manage typed IDs for Affinity API calls?

You need the Affinity Python SDK to manage typed IDs for Affinity API calls. It natively enforces type safety using specific entity identifiers like PersonId and CompanyId across your automation code.

Why should I use a typed Python SDK instead of raw HTTP requests for Affinity CRM?

A typed Python SDK eliminates the boilerplate of raw HTTP requests for Affinity CRM. It provides clear initialization guidance, typed entities, and structured error handling to ensure safe, productive automation.