Ein Kontaktfoto setzen
Lädt das Foto hoch, das für einen Kontakt angezeigt wird, und ersetzt ein vorhandenes. Der Body ist das Bild selbst, kein JSON, mit seinem Typ in `Content-Type`: `image/png`, `image/jpeg`, `image/webp` oder `image/gif`, bis zu 5 MB. Es wird in ein Quadrat von 512 Pixeln eingepasst und als WebP gespeichert, und von einem animierten Bild bleibt das erste Bild.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
PUT /contacts/{email}/photo
Lädt das Foto hoch, das für einen Kontakt angezeigt wird, und ersetzt ein vorhandenes. Der Body ist das Bild selbst, kein JSON, mit seinem Typ in Content-Type: image/png, image/jpeg, image/webp oder image/gif, bis zu 5 MB. Es wird in ein Quadrat von 512 Pixeln eingepasst und als WebP gespeichert, und von einem animierten Bild bleibt das erste Bild.
Beispiel
Erfordert contacts:write. Die Adresse muss ein gespeicherter Kontakt sein, speichere sie also zuerst mit PUT /contacts/{email}.
curl -X PUT "$OE/contacts/grace%40example.com/photo" -H "$AUTH" -H 'content-type: image/jpeg' --data-binary @grace.jpg{ "object": "contact", "email": "[email protected]", "name": "Grace Hopper", "source": "manual", "notes": null, "photoUrl": "https://cdn-prod.openemail.uk/contacts/photos/5b0e2c7a-91d4-4f3e-8a26-c4f1d9e07b3a.webp", "lastSeenAt": null, "createdAt": "2026-09-18T09:00:00.000Z", "updatedAt": "2026-09-23T10:20:00.000Z", "audiences": [ { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" } ]}Eine Adresse, die kein gespeicherter Kontakt ist, ist ein 404 contact_not_found. Ein Body, der kein Bild eines erlaubten Typs ist, größer als 5 MB ist oder sich nicht lesen lässt, ist ein 422 invalid_image.
Ein ausgelasteter Bilddienst antwortet mit 503 image_busy, was sich gefahrlos wiederholen lässt. Jeder Upload bekommt eine neue photoUrl, sodass ein zwischengespeichertes altes Foto nie unter dem neuen erscheint.