Using the API to set the primary email for a user

Question

How can I update the primary email address for a user using the API?

Answer

A user's primary email address is controlled through the User Identities endpoints of our API.

To set an existing secondary email address as the primary email address, use the Make Identity Primary endpoint.

To update an existing email address, including the existing primary email address, use the Update Identity endpoint.

The user verification status will change depending on the method the user takes to verify ownership their email address. For example, an API verification will mark the user's verification status as low.

Note: Use the API Usage dashboard and possible rate limits.

For more information, see this article: Support API.