add-contact-address

name	add_contact_address
description	Attach a postal address (home, work, billing, shipping) to an existing contact.
when_to_use	- User dictates a new address for an existing contact. - YOU asked the user for grandma's address (after find_person returned no address), they gave it — call this to persist it. - For business contacts, billing address typically differs from shipping — use kind='billing' or 'shipping' explicitly. - Always call find_person first to get the right contact_id.
inputs	{"contact_id":{"type":"integer","required":true},"kind":{"type":"string","required":false,"default":"home","description":"'home' | 'work' | 'billing' | 'shipping' | 'other'."},"line1":{"type":"string","required":false,"description":"Street + house number. At least one of line1/line2/postcode/city must be provided."},"line2":{"type":"string","required":false},"postcode":{"type":"string","required":false},"city":{"type":"string","required":false},"region":{"type":"string","required":false,"description":"State / canton / Bundesland."},"country":{"type":"string","required":false,"description":"ISO 3166-1 alpha-2 ('DE', 'CH', 'US', …) preferred."},"label":{"type":"string","required":false}}
outputs	{"address_id":{"type":"integer"},"contact":{"type":"object"}}
permissions	["admin","member","restricted"]
side_effects	1 row in contact_addresses
tags	["contacts","mutation"]

add_contact_address

Multiple addresses per contact are normal — Oma's home, the office she works at, a billing address for a business. Use the kind field so Compose knows which one to render for invoices vs. letters.