---
title: "List Senders"
method: GET
path: "/api/senders"
tags: ["senders"]
---

# List Senders

`GET /api/senders`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/senders`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

## Response `200`

Successful Response

- SenderWithAccountsPayload[]
  - `accounts` SenderAccountPayload[]
    - `account_kind` 'mailbox' | 'linkedin_account', required
    - `channel` 'email' | 'linkedin', required
    - `connection_status` 'pending' | 'connected' | 'expired' | 'revoked' | 'error' | 'disconnected', required
    - `created_at` string, date-time, required
    - `created_by_user_id` string, required
    - `daily_send_limit` integer, nullable
    - `domain_id` string, nullable
    - `external_account_id` string, nullable
    - `health_status` 'unknown' | 'healthy' | 'warning' | 'degraded' | 'critical' | 'paused', required
    - `identifier` string, required
    - `is_default` boolean, required
    - `last_synced_at` string, date-time, nullable
    - `metadata` object
    - `organization_uuid` string, required
    - `outbound_readiness` 'ready' | 'warming' | 'partial' | 'paused' | 'blocked', nullable
    - `outbound_readiness_actions` string[]
    - `outbound_readiness_lanes` OutboundReadinessLanePayload[]
      - `action` 'LINKEDIN_CONNECTION_REQUEST' | 'SEND_LINKEDIN_MESSAGE' | 'SEND_INMAIL' | 'LINKEDIN_ANY_OUTBOUND', required
      - `daily_cap` integer, nullable
      - `healthy` boolean, required
      - `label` string, required
      - `reason` string, nullable
      - `stage` 'new' | 'ramping' | 'established' | 'recovery' | 'paused', required
      - `user_action` string, nullable
      - `weekly_cap` integer, nullable
    - `outbound_readiness_reason` string, nullable
    - `outbound_readiness_summary` string, nullable
    - `outbound_readiness_user_action` string, nullable
    - `provider` 'google' | 'microsoft' | 'linkedin' | 'inboxkit' | 'resend' | 'namecheap' | 'cloudflare' | 'manual' | 'other', required
    - `provider_link_id` string, nullable
    - `sender_account_id` string, required
    - `sender_id` string, nullable
    - `status` 'active' | 'archived', required
    - `updated_at` string, date-time, required
    - `updated_by_user_id` string, required
    - `warmup_ramp` WarmupRampPayload
      - `current_cap` integer, nullable
      - `day_index` integer, required
      - `days_remaining` integer, required
      - `disabled` boolean
      - `in_warmup` boolean, required
      - `target_cap` integer, required
    - `warmup_status` 'not_applicable' | 'pending' | 'warming' | 'ready' | 'paused' | 'error', required
  - `provider_links` SenderProviderLinkPayload[]
    - `authorized_by_user_id` string, nullable
    - `created_at` string, date-time, required
    - `external_subject_id` string, nullable
    - `link_kind` 'mailbox_oauth' | 'linkedin_oauth' | 'domain_vendor' | 'mailbox_vendor' | 'other', required
    - `metadata` object
    - `organization_uuid` string, required
    - `provider` 'google' | 'microsoft' | 'linkedin' | 'inboxkit' | 'resend' | 'namecheap' | 'cloudflare' | 'manual' | 'other', required
    - `provider_link_id` string, required
    - `scopes` string[]
    - `secret_ref` string, nullable
    - `status` 'pending' | 'active' | 'expired' | 'revoked' | 'error', required
    - `updated_at` string, date-time, required
  - `sender` SenderPayload, required
    - `calendar_link` string, nullable
    - `created_at` string, date-time, required
    - `created_by_user_id` string, required
    - `display_name` string, nullable
    - `first_name` string, required
    - `last_name` string, required
    - `linked_auth_user_id` string, nullable
    - `linkedin_profile_url` string, nullable
    - `metadata` object
    - `organization_uuid` string, required
    - `primary_email` string, nullable
    - `sender_id` string, required
    - `sending_schedule` SendingSchedulePayload
      - `days_of_week` integer[], required
      - `send_window_end` string, required
      - `send_window_start` string, required
      - `timezone` string, required
    - `status` 'active' | 'archived', required
    - `updated_at` string, date-time, required
    - `updated_by_user_id` string, required

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)