Add Avatar for User

POST

/domains/{domain}/users/{user}/avatar

Last modified:2026-07-28 22:45:01

Adds the avatar for a user.

Accepted formats: JPEG, PNG, GIF (first frame only) and WebP. The format is detected from the file contents, not the filename or content type.

Size: maximum 20 MB per upload.

Aspect ratio: the image must be square (1:1). A non-square image is rejected with 400 — crop client-side before uploading (Horizon offers auto-crop).

What gets stored: two WebP variants are generated and stored in the database, 256x256 (under 100 KB) and 48x48 (under 20 KB). Every upload is re-encoded, which strips EXIF/GPS metadata. Images are never upscaled.

Replacement is atomic: the new image is written, the user/contact record is repointed at it, then the previous image is deleted. If the record cannot be repointed the new image is rolled back and 500 is returned, so a caller never receives a filename that nothing references.

POST and PUT are equivalent here — both create or replace.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params multipart/form-dataRequired

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains/example.com/users/1000/avatar' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""'

Response Example

{
    "filename": "string",
    "user": "1000",
    "domain": "example.com",
    "filetype": "string",
    "filesize-large-bytes": 0,
    "filesize-small-bytes": 0,
    "path": "string",
    "path-small": "string",
    "path-large": "string",
    "file-modified-for-limits": "string"
}

Modified at 2026-07-28 22:45:01

Add/Update Avatar for Domains's Shared Contact

Add Avatar for User's Contact