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

**URL:** <https://integration.keap.com/t/v2-notes-api-webhook-lookup-requires-contact-id-missing-date-filtering/94016>\
**Category:** API Q&A\
**Tags:** api\
**Created:** [April 15, 2026, 10:33pm UTC](https://integration.keap.com/t/v2-notes-api-webhook-lookup-requires-contact-id-missing-date-filtering/94016 "2026-04-15T22:33:25Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![Dustin\_Lunt](https://sea1.discourse-cdn.com/flex019/user_avatar/integration.keap.com/dustin_lunt/32/15037_2.png) [@Dustin\_Lunt](https://integration.keap.com/u/Dustin_Lunt)\
**Post date:** [April 15, 2026, 10:33pm UTC](https://integration.keap.com/t/v2-notes-api-webhook-lookup-requires-contact-id-missing-date-filtering/94016/1 "2026-04-15T22:33:25Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![OmarAlmonte](https://sea1.discourse-cdn.com/flex019/user_avatar/integration.keap.com/omaralmonte/32/15105_2.png) [@OmarAlmonte](https://integration.keap.com/u/OmarAlmonte)\
**Post date:** [April 16, 2026, 12:00pm UTC](https://integration.keap.com/t/v2-notes-api-webhook-lookup-requires-contact-id-missing-date-filtering/94016/2 "2026-04-16T12:00:42Z")

</div>

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](https://thryv.sharepoint.com/:x:/t/KeapGryffindor/IQDVNiI3rp3bTJDw0sP8qVB5ASDfArlNJJ6CFEMgLIhGw8s)). 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.

---

<div class="post-metadata">

**Author:** ![OmarAlmonte](https://sea1.discourse-cdn.com/flex019/user_avatar/integration.keap.com/omaralmonte/32/15105_2.png) [@OmarAlmonte](https://integration.keap.com/u/OmarAlmonte)\
**Post date:** [May 25, 2026, 7:26pm UTC](https://integration.keap.com/t/v2-notes-api-webhook-lookup-requires-contact-id-missing-date-filtering/94016/3 "2026-05-25T19:26:20Z")

</div>

Hi @Dustin_lunt, quick update on the notes use case. We recently released `GET /v2/notes`, which allows listing notes without requiring a contact ID in the path. Docs for reference: [Keap REST API](https://developer.infusionsoft.com/docs/restv2/#tag/Note/operation/listAllNotes). Thanks again for your feedback.

Best,  
Omar