November 17, 2026
Contacts
You can now group contacts into Lists, write private notes about a contact, and create custom field definitions. You can also filter List Contacts by a List or View.
New endpoints
- GET /contact_lists – List the Lists and Views that a user saved. Use the
typeparameter to return onlystatic_listor onlydynamic_viewitems. - POST /contact_lists – Create a List and, optionally, add contacts to it. You cannot create a View with this endpoint.
- GET /contact_lists/{uuid} – Retrieve one List or View.
- PATCH /contact_lists/{uuid} – Rename a List or View. Only the name can change.
- POST /contact_lists/{uuid}/memberships – Add up to 500 contacts to a List. This operation is idempotent.
- POST /contact_lists/{uuid}/memberships/removal – Remove up to 500 contacts from a List. The contacts are not deleted.
- GET /notes – List the notes about 1 to 10 contacts. The
contactparameter is required. - POST /notes – Create a note about one contact. Send a
title, abody, or both. Add a reminder withremind_at. - GET /notes/{uuid} – Retrieve one note.
- POST /contacts/custom_field_definitions – Create a custom field definition.
Updated endpoints
- GET /contacts – Accepts the optional
contact_listparameter. Send a contact list URI to return only the contacts in that List or View.
Notes
- These endpoints use the existing
contacts:readandcontacts:writescopes. - A note is private. You can read only the notes that you wrote. Notes that other users wrote about the same contact are not returned.
- A user can have at most 25 Lists and Views. Views that a CSV import creates count toward this limit, but the API does not return them.
Availability
You can now create an availability schedule for a user and change an existing one.
New endpoints
- POST /user_availability_schedules – Create an availability schedule for the authenticated user. Send exactly one
wdayrule for each day of the week. - PATCH /user_availability_schedules/{uuid} – Update the name, time zone, or rules of a schedule, or make it the default.
Notes
- These endpoints use the existing
availability:writescope. Its description is now “Create and update availability schedules for users and event types.” rulesreplaces the full rule set. To change one weekday or one date, read the schedule with GET /user_availability_schedules/{uuid}, edit it, and send all the rules back.