zklogin.clientAdd

Details

Endpoint: POST /v1/zklogin/clients
Credits: Free
Rate class: Light. Counts against your light requests per second.

Only JWTs whose aud is a client id registered to your account are accepted. Send clientId alone to start using it. Send jwt too (any ID token issued for that client id, up to 30 days old) to verify that the client id is yours: verifying is needed to import salts, and a verified claim takes over an unverified one by another account. Free.

Parameters

Name	Type	Description
clientIdrequired	string	The OAuth client id, like 1234-abc.apps.googleusercontent.com.
jwt	string	Optional ID token issued for this client id, to verify it.
iss	string	Issuer. Default https://accounts.google.com.

Request

Send your key in the x-api-key header, or leave it out to use the keyless tier.

curl

curl -X POST "https://api.tide.ad/v1/zklogin/clients" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "clientId": "1234567890-abc.apps.googleusercontent.com"
}'

TypeScript

const res = await fetch("https://api.tide.ad/v1/zklogin/clients", {
  method: "POST",
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
    "content-type": "application/json",
  },
  body: JSON.stringify({
    "clientId": "1234567890-abc.apps.googleusercontent.com"
  }),
});
const data = await res.json();

Response

JSON

{
  "iss": "https://accounts.google.com",
  "clientId": "1234567890-abc.apps.googleusercontent.com",
  "verified": false
}