Skip to content

Sender

Senders are the email mailboxes and LinkedIn accounts sequences send from. Creating, connecting and archiving a sender happen in the Lightfield app.

Retrieve a sender
client.Sender.Get(ctx, id) (*SenderRetrieveResponse, error)
GET/v1/senders/{id}
List senders
client.Sender.List(ctx, query) (*SenderListResponse, error)
GET/v1/senders
Update a sender
client.Sender.Update(ctx, id, body) (*SenderUpdateResponse, error)
POST/v1/senders/{id}
Mark a sender healthy
client.Sender.MarkHealthy(ctx, id, body) (*SenderMarkHealthyResponse, error)
POST/v1/senders/{id}/mark_healthy
ModelsExpand Collapse
type SenderListResponse struct{…}
Data []SenderListResponseData
ID string

Unique identifier of the sender.

ArchivedAt string

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

Channel string

Whether this sender sends email or LinkedIn messages.

One of the following:
const SenderListResponseDataChannelEmail SenderListResponseDataChannel = "EMAIL"
const SenderListResponseDataChannelLinkedin SenderListResponseDataChannel = "LINKEDIN"
CreatedAt string

When the sender was created.

EmailAddress string

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

Health string

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:
const SenderListResponseDataHealthUnverified SenderListResponseDataHealth = "UNVERIFIED"
const SenderListResponseDataHealthHealthy SenderListResponseDataHealth = "HEALTHY"
const SenderListResponseDataHealthUnhealthy SenderListResponseDataHealth = "UNHEALTHY"
HealthReason string

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

ObjectType string

Always sender.

Owner string

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

Pacing SenderListResponseDataPacing

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 SenderListResponseDataPacingEmailOptional

Email steps. Present only on an email sender.

DailyLimit int64

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

minimum-9007199254740991
maximum9007199254740991
MaxGapSeconds int64

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
MinGapSeconds int64

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

minimum-9007199254740991
maximum9007199254740991
LinkedinInvite SenderListResponseDataPacingLinkedinInviteOptional

LinkedIn connection requests. Present only on a LinkedIn sender.

DailyLimit int64

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

minimum-9007199254740991
maximum9007199254740991
MaxGapSeconds int64

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
MinGapSeconds int64

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

minimum-9007199254740991
maximum9007199254740991
LinkedinMessage SenderListResponseDataPacingLinkedinMessageOptional

LinkedIn messages. Present only on a LinkedIn sender.

DailyLimit int64

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

minimum-9007199254740991
maximum9007199254740991
MaxGapSeconds int64

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
MinGapSeconds int64

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

minimum-9007199254740991
maximum9007199254740991
ReplyToAddress string

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

Transport string

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:
const SenderListResponseDataTransportSmtp SenderListResponseDataTransport = "SMTP"
const SenderListResponseDataTransportOAuth SenderListResponseDataTransport = "OAUTH"
Object SenderListResponseObject
TotalCount int64
minimum-9007199254740991
maximum9007199254740991
type SenderMarkHealthyResponse struct{…}
ID string

Unique identifier of the sender.

ArchivedAt string

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

Channel SenderMarkHealthyResponseChannel

Whether this sender sends email or LinkedIn messages.

One of the following:
const SenderMarkHealthyResponseChannelEmail SenderMarkHealthyResponseChannel = "EMAIL"
const SenderMarkHealthyResponseChannelLinkedin SenderMarkHealthyResponseChannel = "LINKEDIN"
CreatedAt string

When the sender was created.

EmailAddress string

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

Health SenderMarkHealthyResponseHealth

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:
const SenderMarkHealthyResponseHealthUnverified SenderMarkHealthyResponseHealth = "UNVERIFIED"
const SenderMarkHealthyResponseHealthHealthy SenderMarkHealthyResponseHealth = "HEALTHY"
const SenderMarkHealthyResponseHealthUnhealthy SenderMarkHealthyResponseHealth = "UNHEALTHY"
HealthReason string

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

ObjectType SenderMarkHealthyResponseObjectType

Always sender.

Owner string

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

Pacing SenderMarkHealthyResponsePacing

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 SenderMarkHealthyResponsePacingEmailOptional

Email steps. Present only on an email sender.

DailyLimit int64

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

minimum-9007199254740991
maximum9007199254740991
MaxGapSeconds int64

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
MinGapSeconds int64

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

minimum-9007199254740991
maximum9007199254740991
LinkedinInvite SenderMarkHealthyResponsePacingLinkedinInviteOptional

LinkedIn connection requests. Present only on a LinkedIn sender.

DailyLimit int64

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

minimum-9007199254740991
maximum9007199254740991
MaxGapSeconds int64

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
MinGapSeconds int64

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

minimum-9007199254740991
maximum9007199254740991
LinkedinMessage SenderMarkHealthyResponsePacingLinkedinMessageOptional

LinkedIn messages. Present only on a LinkedIn sender.

DailyLimit int64

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

minimum-9007199254740991
maximum9007199254740991
MaxGapSeconds int64

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
MinGapSeconds int64

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

minimum-9007199254740991
maximum9007199254740991
ReplyToAddress string

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

Transport SenderMarkHealthyResponseTransport

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:
const SenderMarkHealthyResponseTransportSmtp SenderMarkHealthyResponseTransport = "SMTP"
const SenderMarkHealthyResponseTransportOAuth SenderMarkHealthyResponseTransport = "OAUTH"
type SenderRetrieveResponse struct{…}
ID string

Unique identifier of the sender.

ArchivedAt string

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

Channel SenderRetrieveResponseChannel

Whether this sender sends email or LinkedIn messages.

One of the following:
const SenderRetrieveResponseChannelEmail SenderRetrieveResponseChannel = "EMAIL"
const SenderRetrieveResponseChannelLinkedin SenderRetrieveResponseChannel = "LINKEDIN"
CreatedAt string

When the sender was created.

EmailAddress string

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

Health SenderRetrieveResponseHealth

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:
const SenderRetrieveResponseHealthUnverified SenderRetrieveResponseHealth = "UNVERIFIED"
const SenderRetrieveResponseHealthHealthy SenderRetrieveResponseHealth = "HEALTHY"
const SenderRetrieveResponseHealthUnhealthy SenderRetrieveResponseHealth = "UNHEALTHY"
HealthReason string

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

ObjectType SenderRetrieveResponseObjectType

Always sender.

Owner string

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

Pacing SenderRetrieveResponsePacing

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 SenderRetrieveResponsePacingEmailOptional

Email steps. Present only on an email sender.

DailyLimit int64

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

minimum-9007199254740991
maximum9007199254740991
MaxGapSeconds int64

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
MinGapSeconds int64

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

minimum-9007199254740991
maximum9007199254740991
LinkedinInvite SenderRetrieveResponsePacingLinkedinInviteOptional

LinkedIn connection requests. Present only on a LinkedIn sender.

DailyLimit int64

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

minimum-9007199254740991
maximum9007199254740991
MaxGapSeconds int64

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
MinGapSeconds int64

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

minimum-9007199254740991
maximum9007199254740991
LinkedinMessage SenderRetrieveResponsePacingLinkedinMessageOptional

LinkedIn messages. Present only on a LinkedIn sender.

DailyLimit int64

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

minimum-9007199254740991
maximum9007199254740991
MaxGapSeconds int64

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
MinGapSeconds int64

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

minimum-9007199254740991
maximum9007199254740991
ReplyToAddress string

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

Transport SenderRetrieveResponseTransport

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:
const SenderRetrieveResponseTransportSmtp SenderRetrieveResponseTransport = "SMTP"
const SenderRetrieveResponseTransportOAuth SenderRetrieveResponseTransport = "OAUTH"
type SenderUpdateResponse struct{…}
ID string

Unique identifier of the sender.

ArchivedAt string

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

Channel SenderUpdateResponseChannel

Whether this sender sends email or LinkedIn messages.

One of the following:
const SenderUpdateResponseChannelEmail SenderUpdateResponseChannel = "EMAIL"
const SenderUpdateResponseChannelLinkedin SenderUpdateResponseChannel = "LINKEDIN"
CreatedAt string

When the sender was created.

EmailAddress string

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

Health SenderUpdateResponseHealth

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:
const SenderUpdateResponseHealthUnverified SenderUpdateResponseHealth = "UNVERIFIED"
const SenderUpdateResponseHealthHealthy SenderUpdateResponseHealth = "HEALTHY"
const SenderUpdateResponseHealthUnhealthy SenderUpdateResponseHealth = "UNHEALTHY"
HealthReason string

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

ObjectType SenderUpdateResponseObjectType

Always sender.

Owner string

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

Pacing SenderUpdateResponsePacing

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 SenderUpdateResponsePacingEmailOptional

Email steps. Present only on an email sender.

DailyLimit int64

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

minimum-9007199254740991
maximum9007199254740991
MaxGapSeconds int64

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
MinGapSeconds int64

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

minimum-9007199254740991
maximum9007199254740991
LinkedinInvite SenderUpdateResponsePacingLinkedinInviteOptional

LinkedIn connection requests. Present only on a LinkedIn sender.

DailyLimit int64

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

minimum-9007199254740991
maximum9007199254740991
MaxGapSeconds int64

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
MinGapSeconds int64

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

minimum-9007199254740991
maximum9007199254740991
LinkedinMessage SenderUpdateResponsePacingLinkedinMessageOptional

LinkedIn messages. Present only on a LinkedIn sender.

DailyLimit int64

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

minimum-9007199254740991
maximum9007199254740991
MaxGapSeconds int64

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
MinGapSeconds int64

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

minimum-9007199254740991
maximum9007199254740991
ReplyToAddress string

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

Transport SenderUpdateResponseTransport

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:
const SenderUpdateResponseTransportSmtp SenderUpdateResponseTransport = "SMTP"
const SenderUpdateResponseTransportOAuth SenderUpdateResponseTransport = "OAUTH"