Contact log

Record the contact your team has had with a donor — a phone call, a meeting, a letter — each with a note and an optional follow-up date. These are your own entries; donations and the receipt/processing emails Together sends are separate resources.

When to use this

The contact log is for human-recorded touchpoints: “called Jane about the spring appeal”, “coffee with the Acme board”. Create an entry whenever your CRM or your own tooling logs a contact you want reflected on the donor's Together record.

Donations are recorded through /api/v1/donations, not here. The in-app donor “Activity” view merges contact log entries, donations, and the emails Together sent into one timeline, but over the API each of those is its own resource.

The entry

Field	Notes
`donor_id`	Required on create. Must belong to your organisation, else 404.
`contact_method`	One of `PHONE`, `MEETING`, `EMAIL`, `LETTER`, `SMS`, `OTHER`.
`occurred_at`	ISO 8601 datetime of when the contact happened. Back-date it for past contact.
`notes`	Free text (optional), up to 5000 characters.
`follow_up_at`	Optional next-action date. Set `follow_up_completed_at` to mark it done, or send `follow_up_at: null` to clear it.
`recorded_by_id`	The user who logged it. Entries created over the API have `null` here.

Create a contact

curl -X POST https://your-org.alltogether.giving/api/v1/contact-logs \
  -H "Authorization: Bearer $TOGETHER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "donor_id": "cm3donor0001abc123xyz456",
    "contact_method": "PHONE",
    "occurred_at": "2026-06-10T02:00:00.000Z",
    "notes": "Discussed the year-end appeal; keen to give again.",
    "follow_up_at": "2026-06-25T00:00:00.000Z"
  }'

List and filter

List entries newest-first. Soft-deleted entries are never returned.

Query	Effect
`donor_id`	Only entries for that donor.
`method`	Filter by contact method.
`follow_up=open`	Only entries with an outstanding (incomplete) follow-up.

curl "https://your-org.alltogether.giving/api/v1/contact-logs?donor_id=cm3donor0001abc123xyz456&follow_up=open" \
  -H "Authorization: Bearer $TOGETHER_API_KEY"

Complete a follow-up

curl -X PATCH https://your-org.alltogether.giving/api/v1/contact-logs/$ID \
  -H "Authorization: Bearer $TOGETHER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "follow_up_completed_at": "2026-06-20T00:00:00.000Z" }'

A WRITE-scoped key can read; create, update, and delete entries. DELETE is a soft-delete — the entry stops appearing in lists and the donor timeline, and the call is idempotent.