attio-hello-world

# Attio Hello World ## Overview Five progressively deeper API calls that exercise the Attio object/record model. Every call targets `https://api.attio.com/v2` and returns JSON. ## Prerequisites - Completed `attio-install-auth` (valid `ATTIO_API_KEY` in env) - Scopes: `object_configuration:read`, `record_permission:read`, `record_permission:read-write` ## Instructions ### Step 1: List Workspace Objects Every Attio workspace has system objects (people, companies) and optional objects (deals, users, workspaces). Custom objects can be created. ```bash curl -s https://api.attio.com/v2/objects \ -H "Authorization: Bearer ${ATTIO_API_KEY}" | jq '.data[] | {slug: .api_slug, singular: .singular_noun}' ``` ```json {"slug": "people", "singular": "Person"} {"slug": "companies", "singular": "Company"} {"slug": "deals", "singular": "Deal"} ``` ### Step 2: List Attributes on an Object Objects have attributes (fields). Use the slug from Step 1. ```bash curl -s "https://api.attio.com/v2/objects/people/attributes" \ -H "Authorization: Bearer ${ATTIO_API_KEY}" | jq '.data[] | {slug: .api_slug, type: .type}' ``` Common people attributes: `name` (personal-name), `email_addresses` (email-address), `phone_numbers` (phone-number), `description` (text), `primary_location` (location), `company` (record-reference). ### Step 3: Create a Person Record ```typescript const person = await attioFetch<{ data: { id: { record_id: string } } }>({ method: "POST", path: "/objects/people/reco...