Contacts

Contacts are the people and businesses you transact with — customers and vendors. They give your entries and reports a counterparty.

Contact types

Each contact has a contact_type:

Type	Meaning
`client`	Someone you invoice / receive money from.
`vendor`	Someone you pay / receive bills from.
`both`	Acts as both a client and a vendor.

Managing contacts

Operation	Endpoint
Create	`POST /contacts`
List	`GET /contacts`
Get one	`GET /contacts/{id}`
Update	`PATCH /contacts/{id}`

bash

curl -X POST "$FLYWHEEL_API/contacts" \
-H "Authorization: Bearer $FLYWHEEL_KEY" \
-H "Content-Type: application/json" \
-d '{
  "name": "Acme Corp",
  "contact_type": "client",
  "email": "ap@acme.example",
  "currency": "USD"
}'

Optional fields include email, phone, address, tax_id, currency, and free-form metadata.

MCP tools

create_contact, list_contacts, get_contact, and update_contact. See the API reference for full field definitions.