Get the sender photo

The workspace's sender photo, whether it syncs, earlier photos, and each managed mailbox's state. Applied at the provider is not proof a recipient sees the photo. Senders signed in directly are listed as unsupported.

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

Scope: read
MCP tool: get_sender_photo

Request

curl https://app.trygtm.com/api/v1/senders/photo \
  -H "Authorization: Bearer $TRYGTM_API_KEY"

Response

{
  "data": {
    "available": true,
    "vendor_supported": true,
    "can_manage": true,
    "photo": {
      "asset_id": "7d8e9f0a-1b2c-4d3e-8f4a-5b6c7d8e9f0a",
      "url": "https://storage.example.com/sender-photos/7d8e9f0a-1b2c-4d3e-8f4a-5b6c7d8e9f0a.jpg",
      "width": 512,
      "revision": 3,
      "sync_enabled": true,
      "updated_at": "2026-09-28T10:00:00.000Z"
    },
    "previous": [],
    "mailboxes": [
      {
        "id": "3e4f5a6b-7c8d-4e9f-8a0b-1c2d3e4f5a6b",
        "email": "sam@acme-mail.com",
        "state": "applied",
        "label": "Applied at the provider",
        "error": null,
        "applied_at": "2026-09-28T10:03:00.000Z",
        "next_attempt_at": null
      }
    ],
    "unsupported": [
      {
        "sender_id": "d4c3b2a1-0f9e-4d8c-8b7a-6f5e4d3c2b1a",
        "email": "sam@acme.com",
        "reason": "Signed in with the mailbox's own sign-in. TryGTM has no permission to change its profile photo; change it with the mail provider."
      }
    ],
    "counts": {
      "applied": 1
    },
    "visibility_note": "The photo is set as each managed mailbox's profile picture. Whether a recipient sees it depends on their email provider, and a photo applied at the provider is not proof that a first-time recipient sees it.",
    "removal_note": "Stopping sync leaves each mailbox's current photo in place. Taking a photo off a mailbox is not supported yet; contact support to have it removed at the provider."
  }
}