Verification webhook

Once a user completes (or is removed from) verification, Auth314 sends a one-time POST to the callback_url you supplied in /verify/init.

Payload

{
  "platform_user_id": "123456789",
  "guild_id": "987654321",
  "verified": true
}

Field	Type	Description
platform_user_id	string	Echoes the value you sent to /verify/init.
guild_id	string	Echoes the value you sent to /verify/init.
verified	boolean	true on successful verification. false if this identity's verification was revoked because the same Pi account re-verified under a different platform identity.

Pi identity (UID, username) is never included. See How verification works for why.

Responding

Auth314 expects a 2xx response. Respond quickly and process asynchronously if role assignment, database writes, etc. take meaningful time — Auth314 does not currently retry failed deliveries.

Revocation

If the same Pi account later verifies under a different (platform, platform_user_id, guild_id), Auth314 sends a second webhook to the original callback_url with verified: false for the original identity. Handle this by removing whatever access you granted on the initial verified: true.