Skip to navigation

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 type parameter to return only static_list or only dynamic_view items.
  • 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 contact parameter is required.
  • POST /notes – Create a note about one contact. Send a title, a body, or both. Add a reminder with remind_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_list parameter. Send a contact list URI to return only the contacts in that List or View.

Notes

  • These endpoints use the existing contacts:read and contacts:write scopes.
  • 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 wday rule 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:write scope. Its description is now “Create and update availability schedules for users and event types.”
  • rules replaces 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.