Choose the sender photo

Make one of the workspace's uploaded photos current and turn syncing on. Managed mailboxes are updated in the background. Uploading a new picture stays in the app.

PUThttps://app.trygtm.com/api/v1/senders/photo

Scope: write
MCP tool: set_sender_photo

Headers

Idempotency-Keystringoptional: A key unique to this write, up to 255 characters. A retry carrying the same key returns the first response instead of running again. Kept for 24 hours.

Body

photo_idstringrequired: The photo's id: photo.assetId or previous[].assetId from get_sender_photo.

Request

curl -X PUT https://app.trygtm.com/api/v1/senders/photo \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "photo_id": "8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10"
  }'

Response

{
  "data": {
    "photo_id": "7d8e9f0a-1b2c-4d3e-8f4a-5b6c7d8e9f0a",
    "revision": 4,
    "url": "https://storage.example.com/sender-photos/7d8e9f0a-1b2c-4d3e-8f4a-5b6c7d8e9f0a.jpg",
    "sync_enabled": true
  }
}