> For the complete documentation index, see [llms.txt](https://api.docs.fan/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api.docs.fan/profile/emails/set-primary.md).

# Set Primary

{% hint style="info" %}
**Coming soon.** This endpoint is available in the profile service but is not yet exposed through the gateway. The path and payload may change when it becomes available externally.
{% endhint %}

Use this endpoint to promote a verified email to be the profile's primary email. The email must belong to the profile and be verified.

### Required Scopes

`profile_emails:update` *(provisional — final scope will be confirmed when this endpoint is exposed via the gateway)*

## Request

### URL

`POST /v2/profile/{id}/emails/{email_id}/primary`

### Path Parameters

| Name       | Required | Description                                    |
| ---------- | -------- | ---------------------------------------------- |
| `id`       | true     | Profile ID.                                    |
| `email_id` | true     | Identifier of the email to promote to primary. |

## Response

Returns `204 No Content` on success. A `409 Conflict` is returned if the email cannot be promoted (for example, it is not verified).

## Full Spec

{% openapi src="/files/CCf2AQODBJ1168Vmfc8L" path="/v2/profile/{id}/emails/{email\_id}/primary" method="post" %}
[openapi-profile-service.json](https://3657007978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1G9XmPfyfOHS6i6FdlzL%2Fuploads%2Fgit-blob-d088b26ede7e3b615a2eed648392b766b2122ce9%2Fopenapi-profile-service.json?alt=media)
{% endopenapi %}