V2 Notes API: Webhook Lookup Requires Contact ID + Missing Date Filtering

API Q&A
1

Hi team,

I wanted to flag a couple of inconsistencies I’ve run into with the v2 Notes API that I’d love to see addressed.

  1. Contact ID requirement in v2 routes — When receiving a Note webhook, the payload only includes the note ID. Since the v2 Notes endpoint is nested under a contact ID (e.g. /contacts/{contactId}/notes), it’s not possible to look up the note directly. This forces a fallback to the v1 API, which undermines the value of v2. The Tasks API, by contrast, doesn’t have this issue — a note ID alone should be sufficient to retrieve a note, consistent with how other endpoints behave.

  2. No date-based filtering in v1 — With v2 endpoints for tasks, contacts, and other records, I can filter by created or updated date. That capability is missing from the Notes API, and v1 doesn’t offer it as an alternative. This makes it difficult to efficiently sync or retrieve notes created after a specific date.

Are there plans to address either of these? Happy to provide more context or examples if helpful.

Thanks

2

Hi @Dustin_Lunt,

Thank you for the detailed feedback, it’s very helpful.

Both points you raised are known gaps on our side (item #30 in the known issues tracker). I’ll ensure date filtering is included in the v2 requirements so it fully meets your needs. The limitation in v1, however, will not be addressed as it will be covered in v2.

Please feel free to monitor that item for updates, and I’ll let you know as soon as it’s released.