"The endpoint ID is not specified": old client without SNI

TL;DR

Neon routes connections using Server Name Indication (SNI): the endpoint ID is the first part of the hostname. Old libpq-based clients (some psql builds, Java tools on pgJDBC, old drivers) were built without SNI support, so Neon cannot tell which endpoint you want.

Steps

1. - Upgrade the Postgres client library for SNI support (preferred).

• Or pass the endpoint ID explicitly as a connection parameter: options=endpoint%3D[endpoint-id] (the endpoint ID is the first part of the hostname).

When to use

You are seeing this: ERROR: The endpoint ID is not specified on connect, from older or native Postgres clients. Use this skill when you run into ""The endpoint ID is not specified": old client without SNI".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

Neon routes connections using Server Name Indication (SNI): the endpoint ID is the first part of the hostname.

Neon's connection error docs (verified live 2026-09-26): with older clients lacking SNI support, either upgrade the libpq client library or pass the endpoint ID (first part of the domain name) as a parameter via options.