## Update a sender `sender.update(strid, SenderUpdateParams**kwargs) -> SenderUpdateResponse` **post** `/v1/senders/{id}` Replaces a sender's pacing and returns the updated sender. Send exactly the sender's step types, with every value: read the sender first to change only some of them. Concurrent updates are last-write-wins. Each step type must stay within the ceilings the workspace's own limits have, and `maxGapSeconds` can't be below `minGapSeconds`: `EMAIL` on an OAuth sender `dailyLimit` at least 1 and gaps 60 to 3600 seconds; `EMAIL` on an SMTP sender `dailyLimit` 1 to 100 and gaps 60 to 3600 seconds; `LINKEDIN_INVITE` `dailyLimit` 1 to 30 and gaps 120 to 3600 seconds; `LINKEDIN_MESSAGE` `dailyLimit` 1 to 60 and gaps 120 to 3600 seconds. Out-of-range values, or step types the sender doesn't send, return 400. Returns 409 if the sender is archived; archived senders can be read but not updated. **[Required scope](/using-the-api/scopes/):** `senders:update` **[Rate limit category](/using-the-api/rate-limits/):** Write ### Parameters - `id: str` Unique identifier of the sender to update. - `pacing: Pacing` The sender's new pacing, replacing all of its current values. Send exactly the step types the sender's channel sends: `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. - `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`. - `min_gap_seconds: int` Lower bound of the minimum spacing between two of its sends, in seconds. - `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. - `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`. - `min_gap_seconds: int` Lower bound of the minimum spacing between two of its sends, in seconds. - `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. - `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`. - `min_gap_seconds: int` Lower bound of the minimum spacing between two of its sends, in seconds. ### Returns - `class SenderUpdateResponse: …` - `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. - `"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. - `"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`. - `"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. - `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`. - `min_gap_seconds: int` Lower bound of the minimum spacing between two of its sends, in seconds. - `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. - `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`. - `min_gap_seconds: int` Lower bound of the minimum spacing between two of its sends, in seconds. - `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. - `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`. - `min_gap_seconds: int` Lower bound of the minimum spacing between two of its sends, in seconds. - `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. - `"SMTP"` - `"OAUTH"` ### Example ```python from lightfield import Lightfield client = Lightfield( api_key="My API Key", ) sender_update_response = client.sender.update( id="id", pacing={}, ) print(sender_update_response.id) ``` #### Response ```json { "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" } ```