Query Events Across Multiple Grants Using Metadata Filter

Question and Answers
1

Hi,
In my app, events are created via the Nylas API by different users (grant_ids). I’m planning to use metadata to query events—for example, all events of a customer_id in the next week.

Currently, based on documentation, I need to loop through each grant ID and query separately, which adds complexity and affects performance.

Is there a way to query events across multiple grant IDs in a single request, filtering by metadata?

Thanks!

2

Hello, and thank you for reaching out to Nylas, hopefully I can help you with a solution here:

Nylas Events API requires specifying a single grant ID when querying for events, including when filtering by metadata

  1. (Nylas Email, Calendar, and Contacts API docs | Docs)
  2. (Metadata | Docs)
  3. (Searching with Nylas | Docs)

There is no method to query events across multiple grant IDs in a single request.
You must loop through each grant ID and make separate API calls for each one to retrieve and filter events by metadata

  1. (Nylas Email, Calendar, and Contacts API docs | Docs)
  2. (Metadata | Docs)
  3. (Searching with Nylas | Docs)
3

@HollyHolbrook
Understood, thanks. Regarding performance, do you have documentation on how many query requests the Nylas API supports?

4

The Nylas API enforces rate limits, which control how many requests you can make in a given timeframe. When you hit the rate limit, the API returns a 429 HTTP status code. Nylas recommends implementing an exponential backoff strategy to recover from rate limit errors.

For detailed guidance and the most current rate limit values, refer to the
[rate limits documentation]

  1. (Avoiding rate limits in Nylas | Docs)
  2. (Error handling best practices | Docs)
  3. (Developer guide | Docs)

Cheer,
Holly

1 Like