Customer Contacts

curl -X PATCH https://api.alguna.io/customers/cust_abc123 \
  -H "Authorization: Bearer $ALGUNA_API_KEY" \
  -H "Alguna-Version: 2026-04-01" \
  -H "Content-Type: application/json" \
  -d '{
    "contacts": [
      {
        "id": "cnt_existing01",
        "email": "ap@acme.example",
        "first_name": "Accounts",
        "last_name": "Payable",
        "is_primary": true,
        "email_preferences": ["billing"]
      },
      {
        "email": "counsel@acme.example",
        "first_name": "Dana",
        "last_name": "Reyes",
        "is_primary": false,
        "email_preferences": ["legal"]
      }
    ]
  }'

import os

import requests

HEADERS = {
    "Authorization": f"Bearer {os.environ['ALGUNA_API_KEY']}",
    "Alguna-Version": "2026-04-01",
    "Content-Type": "application/json",
}

customer_url = "https://api.alguna.io/customers/cust_abc123"

# Read the current contacts first: PATCH replaces the whole list.
current = requests.get(customer_url, headers=HEADERS, timeout=10)
current.raise_for_status()
contacts = current.json().get("contacts", [])

contacts.append(
    {
        "email": "counsel@acme.example",
        "first_name": "Dana",
        "last_name": "Reyes",
        "is_primary": False,
        "email_preferences": ["legal"],
    }
)

response = requests.patch(customer_url, headers=HEADERS, json={"contacts": contacts}, timeout=10)
response.raise_for_status()