Skip to content
Lightfield Lightfield
API Reference
Sender

Mark a sender healthy

sender.mark_healthy(strid, SenderMarkHealthyParams**kwargs) -> SenderMarkHealthyResponse
POST/v1/senders/{id}/mark_healthy

Clears a health reason that sending recorded, so the sender can be picked for new sends again, and returns the updated sender. A sender with nothing to clear is returned unchanged.

Clears healthReason BOUNCE_THRESHOLD, RATE_LIMIT, INVITE_LIMIT on an email sender, and RATE_LIMIT, INVITE_LIMIT, UNKNOWN on a LinkedIn sender. Clearing BOUNCE_THRESHOLD turns bounce protection off until hard bounces recur. Contacts the sender paused on their own resume once it can send again, unless another sender they are pinned to still cannot. Sequences an earlier LinkedIn limit deactivated stay deactivated until they are resumed.

Returns 409 for any other health reason, which clears only once its cause is fixed, for example reconnecting the account or fixing DNS; for an archived sender; or when the sender’s health changed while the request ran.

Required scope: senders:update

Rate limit category: Write

ParametersExpand Collapse
id: str

Unique identifier of the sender to mark healthy.

body: Optional[Body]
ReturnsExpand Collapse
class SenderMarkHealthyResponse: …
id: str

Unique identifier of the sender.

archived_at: Optional[str]

When the sender was archived, or null if it is active. Archived senders never send.

channel: Literal["EMAIL", "LINKEDIN"]

Whether this sender sends email or LinkedIn messages.

One of the following:
"EMAIL"
"LINKEDIN"
created_at: str

When the sender was created.

email_address: Optional[str]

The address email from this sender is sent from. Null for LinkedIn senders, or when the connected account has no address.

health: Literal["UNVERIFIED", "HEALTHY", "UNHEALTHY"]

HEALTHY can send. UNHEALTHY cannot send until healthReason is resolved. UNVERIFIED means no health verdict yet: an email sender in this state cannot send until it passes a health check, while a LinkedIn sender is never health-checked, so a working LinkedIn sender is usually UNVERIFIED and can send.

One of the following:
"UNVERIFIED"
"HEALTHY"
"UNHEALTHY"
health_reason: Optional[str]

Why the sender is UNHEALTHY or UNVERIFIED, for example ACCOUNT_DISCONNECTED, BOUNCE_THRESHOLD or INVITE_LIMIT; null when healthy.

object_type: Literal["sender"]

Always sender.

owner: Optional[str]

Member ID of the person who owns this sender, or null when no workspace membership can be resolved.

pacing: Pacing

How this sender paces each step type it sends, keyed by sequence step type: EMAIL for an email sender; LINKEDIN_INVITE and LINKEDIN_MESSAGE for a LinkedIn sender.

email: Optional[PacingEmail]

Email steps. Present only on an email sender.

daily_limit: int

Most sends of this step type in any rolling 24 hours.

minimum-9007199254740991
maximum9007199254740991
max_gap_seconds: Optional[int]

Upper bound of the minimum spacing, in seconds. Before each send, a minimum spacing is drawn at random between minGapSeconds and this value, and the send waits until that long after the previous one. Sends can be further apart, for example outside the send window or once dailyLimit is reached. Null means the minimum spacing is always minGapSeconds.

minimum-9007199254740991
maximum9007199254740991
min_gap_seconds: int

Lower bound of the minimum spacing between two of its sends, in seconds.

minimum-9007199254740991
maximum9007199254740991
linkedin_invite: Optional[PacingLinkedinInvite]

LinkedIn connection requests. Present only on a LinkedIn sender.

daily_limit: int

Most sends of this step type in any rolling 24 hours.

minimum-9007199254740991
maximum9007199254740991
max_gap_seconds: Optional[int]

Upper bound of the minimum spacing, in seconds. Before each send, a minimum spacing is drawn at random between minGapSeconds and this value, and the send waits until that long after the previous one. Sends can be further apart, for example outside the send window or once dailyLimit is reached. Null means the minimum spacing is always minGapSeconds.

minimum-9007199254740991
maximum9007199254740991
min_gap_seconds: int

Lower bound of the minimum spacing between two of its sends, in seconds.

minimum-9007199254740991
maximum9007199254740991
linkedin_message: Optional[PacingLinkedinMessage]

LinkedIn messages. Present only on a LinkedIn sender.

daily_limit: int

Most sends of this step type in any rolling 24 hours.

minimum-9007199254740991
maximum9007199254740991
max_gap_seconds: Optional[int]

Upper bound of the minimum spacing, in seconds. Before each send, a minimum spacing is drawn at random between minGapSeconds and this value, and the send waits until that long after the previous one. Sends can be further apart, for example outside the send window or once dailyLimit is reached. Null means the minimum spacing is always minGapSeconds.

minimum-9007199254740991
maximum9007199254740991
min_gap_seconds: int

Lower bound of the minimum spacing between two of its sends, in seconds.

minimum-9007199254740991
maximum9007199254740991
reply_to_address: Optional[str]

SMTP senders only: the connected mailbox replies are sent to and read from. Null for other senders.

transport: Optional[Literal["SMTP", "OAUTH"]]

How an email sender sends: SMTP through its own mail server, OAUTH through its connected Google or Microsoft account. Null for LinkedIn senders.

One of the following:
"SMTP"
"OAUTH"

Mark a sender healthy

from lightfield import Lightfield

client = Lightfield(
    api_key="My API Key",
)
sender_mark_healthy_response = client.sender.mark_healthy(
    id="id",
)
print(sender_mark_healthy_response.id)
{
  "id": "id",
  "archivedAt": "archivedAt",
  "channel": "EMAIL",
  "createdAt": "createdAt",
  "emailAddress": "emailAddress",
  "health": "UNVERIFIED",
  "healthReason": "healthReason",
  "objectType": "sender",
  "owner": "owner",
  "pacing": {
    "EMAIL": {
      "dailyLimit": -9007199254740991,
      "maxGapSeconds": -9007199254740991,
      "minGapSeconds": -9007199254740991
    },
    "LINKEDIN_INVITE": {
      "dailyLimit": -9007199254740991,
      "maxGapSeconds": -9007199254740991,
      "minGapSeconds": -9007199254740991
    },
    "LINKEDIN_MESSAGE": {
      "dailyLimit": -9007199254740991,
      "maxGapSeconds": -9007199254740991,
      "minGapSeconds": -9007199254740991
    }
  },
  "replyToAddress": "replyToAddress",
  "transport": "SMTP"
}
Returns Examples
{
  "id": "id",
  "archivedAt": "archivedAt",
  "channel": "EMAIL",
  "createdAt": "createdAt",
  "emailAddress": "emailAddress",
  "health": "UNVERIFIED",
  "healthReason": "healthReason",
  "objectType": "sender",
  "owner": "owner",
  "pacing": {
    "EMAIL": {
      "dailyLimit": -9007199254740991,
      "maxGapSeconds": -9007199254740991,
      "minGapSeconds": -9007199254740991
    },
    "LINKEDIN_INVITE": {
      "dailyLimit": -9007199254740991,
      "maxGapSeconds": -9007199254740991,
      "minGapSeconds": -9007199254740991
    },
    "LINKEDIN_MESSAGE": {
      "dailyLimit": -9007199254740991,
      "maxGapSeconds": -9007199254740991,
      "minGapSeconds": -9007199254740991
    }
  },
  "replyToAddress": "replyToAddress",
  "transport": "SMTP"
}