PUT user/…/email-addresses/…/verify

PUT Verifies a user's email address by submitting a previously emailed code.

Having a verified email address is a prerequisite for some use cases.

Resource URL



Field Description

The user ID of the user to retrieve details for. To retrieve the details of the own user account, the value self may be used as well.

Example value: 7OuHq-RcQO_snGWR58TnBw


The email address to verify. The email address must be linked to the given user account.

Example value: john%40example.com


The random based verification code that the user has received in an email message.

Example value: a73c-71ca-ffd3-88c0

If a PUT request has no body (i.e. the body is empty), it is still mandatory to include a Content-Length header (i.e. Content-Length: 0). Not all HTTP clients do this automatically. For more information, please see RFC 2616.


An HTTP 204 (No content) response indicating that the verification code was accepted and that the email address is now considered as verified.

Error responses

The following error situations are possible:

ID Response code Description
not_found 404 (Not found) Requested account was not found
not_permitted 403 (Forbidden) Caller does not have access to account
email_not_verified 400 (Bad request) The email address could not be verified and as a result the account is still only partially funtional