Skip to content
by Unity Nodes
Partner docsapi reference › users › add a contact email

NEAR AI Cloud: Add a contact email

Updated 13-11-2026

POST /v1/users/me/contact-email Add a contact email Deprecated: this endpoint is moving to cloud-platform at the same path; the cloud-platform base URL will be announced. Behaviour may differ in edge cases.

For accounts that sign in with a NEAR wallet and so have no email address. Sends a single-use verification link, valid for 24 hours, to the given address. The address is only saved once the link is confirmed with POST /v1/users/contact-email/verify. The answer is the same whether or not the address belongs to another account (that is reported at confirmation), and whether or not the address already got its emails for the day (then nothing is sent).

Request body (application/json):

  • email (string, required)

Responses: 200: Verification email sent

  • status (string, required): verification_sent after a request, verified after a confirmation. 400: Invalid email address 401: Unauthorized 403: The account does not sign in with a NEAR wallet 404: Contact email verification is not enabled, or user not found 429: Too many verification emails for this user, or the daily limit across all users is reached; see the Retry-After header 500: Internal server error 502: The verification email could not be sent