---
title: "Set avatar for the hashed email"
method: POST
path: "/me/avatars/{imageId}/email"
tags: ["avatars"]
---

# Set avatar for the hashed email

`POST /me/avatars/{imageId}/email`

## Request

- Base URL: `https://api.gravatar.com/v3`
- URL: `https://api.gravatar.com/v3/me/avatars/{imageId}/email`
- Auth: OAuth 2
  - Implicit: `https://public-api.wordpress.com/oauth2/authorize`
- TypeScript: <https://skmtc.dev/automattic/apis/gravatar-public-api/docs/me/avatars/:imageId/email/post.ts> (a function with typed inputs; its response is checked against the schema)

Sets the avatar for the provided email hash.

## Path parameters

- `imageId` string, required

## Request body

- object
  - `email_hash` string, required: The email SHA256 hash to set the avatar for.

## Response `200`

Avatar successfully set

## Other responses

- `401`: Not Authorized
- `403`: Insufficient Scope

## Changes

- **2025-04-10** `57d2f4517079`: 1 breaking, 1 info
  - removed the success response with the status `204`
  - added the success response with the status `200`
- **2024-12-11** `1c9fc9b35a5c`: 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `204`
- **2024-11-26** `0cfe4779525b`: 1 breaking, 1 info
  - removed the success response with the status `204`
  - added the success response with the status `200`
- **2024-10-21** `bd1e2294c942`: 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `204`

[Operation history](https://skmtc.dev/automattic/apis/gravatar-public-api/changes/me/avatars/:imageId/email/post.md)

---

[API](https://skmtc.dev/automattic/apis/gravatar-public-api.md) - [All operations](https://skmtc.dev/automattic/apis/gravatar-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/automattic/apis/gravatar-public-api/revisions/d01551ae9a37?raw)