---
title: "Get one sender by its stable id"
method: GET
path: "/senders/{senderId}"
tags: ["Senders"]
---

# Get one sender by its stable id

`GET /senders/{senderId}`

## Request

- Base URL: `https://origami.chat/api/v2`
- URL: `https://origami.chat/api/v2/senders/{senderId}`
- Auth: HTTP bearer

## Path parameters

- `senderId` string, uuid, required

## Response `200`

The sender.

- Sender: A connected sending account (the roster entry `GET /senders` returns). `id` is stable and is the join key across the API: sequence objects carry it as `senderId` and webhook payloads as `sender.id`.
  - `object` 'sender', required
  - `id` string, uuid, required
  - `channel` 'email' | 'linkedin', required
  - `displayName` string, nullable, required: Human name where known (from-name / LinkedIn profile name); falls back to the email address / slug.
  - `email` string, email, nullable, required: Mailbox address. Null for LinkedIn senders.
  - `linkedinSlug` string, nullable, required: LinkedIn vanity slug (public identifier). Null for email senders.
  - `linkedinUrl` string, uri, nullable, required: Full LinkedIn profile URL derived from the slug.
  - `source` string, required: Normalized provider: gmail | outlook | smtp | linkedin.
  - `origamiOrigin` boolean, required: True when Origami provisioned this account (done-for-you inboxes); false for accounts the user connected themselves.
  - `status` string, required: active | needs_reauth | provisioning | reconnecting | error | disconnected.
  - `createdAt` string, date-time, required

## Other responses

- `404`: SENDER_NOT_FOUND.

## Changes

- **2026-11-03** `8c6b16fe0a3b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/origami/apis/origami-agent-api/changes/senders/:senderId/get.md)

---

[API](https://skmtc.dev/origami/apis/origami-agent-api.md) - [All operations](https://skmtc.dev/origami/apis/origami-agent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/origami/apis/origami-agent-api/revisions/8c6b16fe0a3b?raw)