Determining if you need Nylas v3 Static IPs

Nylas Static IPs

Note: The Nylas v3 API uses a completely different group of IPs than the Nylas v2 API. If you distributed the Nylas IP lists for our v2 API, they are not valid for our v3 API.

 

The Nylas API servers do not normally use static IPs. Our API traffic is sent our via our load balancing service and do not have a list of IPs.

 

We have a special set of API servers that are configured to only use our static IPs. We have a separate list for US and EU Nylas applications. The Static IP list is found here: https://developer.nylas.com/docs/dev-guide/platform/static-ips/

 

If an email server is configured to only allow traffic from specific IPs, they will need our Static IP feature. You should check with email administrators to find if they are doing IP filtering.

 

How do you determine if you need Static IPs?

If an email server is IP filtering, any attempts to connect to it will typically time out or otherwise fail. This will prevent authentication from succeeding and the grant will not be created. This guide will help you determine if this is the case of the authentication failure.

 

If the authentication error mentions being unable to reach the email server, first check with the user's email administrator to confirm that the user is entering the right server URL. This is the cause of most authentication failures when the server can't be reached.

 

If the server URL is correct, but the authentication still fails because it can't reach the email server, there is a straight-forward way to determine if you need static IPs:

1: Have the email administrator whitelist the IPs listed here:

https://developer.nylas.com/docs/dev-guide/platform/static-ips/

2: Have the user attempt to authenticate again and create a grant.

 

If the authentication is successful, a grant is created, but you can't retrieve any objects like messages, folders, events, or calendars from our API, then you will definitely need our Static IPs feature for this email server. We are working on allowing you to self-serve this feature. For now, reach out to your Nylas Account Manager or contact Nylas Support for further assistance.

 

If the authentication is still failing, this is not an IP issue and Static IPs are not needed. If you are confident the user is selecting the right provider and entering the right server URL, please contact Nylas Support for further assistance.

 

If the authentication is successful, a grant is created, you can retrieve items, but you can't send emails via that grant, the email server's SMTP service may need Static IPs.  This will depend on the exact error returned when trying to send the email. If the sending attempt fails because the server times out, they likely need Static IPs.

 

If the authentication is successful and you can retrieve all of the objects and send emails, you either already have Static IPs enabled for your organization, or the email server does not need Static IPs outside of authentication. No further action is needed.

 

Updated

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.