resend

type AddContactSegmentRequest struct {
	SegmentId string `json:"segment_id"`
	ContactId string `json:"contact_id,omitempty"`
	Email     string `json:"email,omitempty"`
}

type AddContactSegmentResponse struct {
	Id     string `json:"id"`
	Object string `json:"object"`
}

type AddInboxThreadLabelsRequest struct {
	// Labels are the IDs of the labels to apply to the thread. Between 1 and 10 IDs, each a label
	// of the inbox. Labels already on the thread stay on it.
	Labels []string `json:"labels"`
}

type AddSuppressionRequest struct {
	Email string `json:"email"`
}

type AddSuppressionResponse struct {
	Object string `json:"object"`
	Id     string `json:"id"`
}

type ApiKey struct {
	Id         string  `json:"id"`
	Name       string  `json:"name"`
	CreatedAt  string  `json:"created_at"`
	LastUsedAt *string `json:"last_used_at"`
}

type ApiKeysSvc interface {
	CreateWithContext(ctx context.Context, params *CreateApiKeyRequest) (CreateApiKeyResponse, error)
	Create(params *CreateApiKeyRequest) (CreateApiKeyResponse, error)
	ListWithOptions(ctx context.Context, options *ListOptions) (ListApiKeysResponse, error)
	ListWithContext(ctx context.Context) (ListApiKeysResponse, error)
	List() (ListApiKeysResponse, error)
	RemoveWithContext(ctx context.Context, apiKeyId string) (bool, error)
	Remove(apiKeyId string) (bool, error)
	UpdateWithContext(ctx context.Context, apiKeyId string, params *UpdateApiKeyRequest) (UpdateApiKeyResponse, error)
	Update(apiKeyId string, params *UpdateApiKeyRequest) (UpdateApiKeyResponse, error)
}

type ApiKeysSvcImpl struct {
	// contains filtered or unexported fields
}

type Attachment struct {
	// Content is the binary content of the attachment to use when a Path
	// is not available.
	Content []byte

	// Filename that will appear in the email.
	// Make sure you pick the correct extension otherwise preview
	// may not work as expected
	Filename string

	// Path where the attachment file is hosted instead of providing the
	// content directly.
	Path string

	// Content type for the attachment, if not set will be derived from
	// the filename property
	ContentType string

	// Optional content ID for the attachment, to be used as a reference in the HTML content.
	// If set, this attachment will be sent as an inline attachment and you can reference it
	// in the HTML content using the `cid:` prefix.
	ContentId string

	// Deprecated: Use ContentId instead. Kept for backwards compatibility.
	// Optional content ID for the attachment, to be used as a reference in the HTML content.
	// If set, this attachment will be sent as an inline attachment and you can reference it
	// in the HTML content using the `cid:` prefix.
	InlineContentId string
}

type AudiencesSvcImpl struct {
	// contains filtered or unexported fields
}

type Automation struct {
	Object      string                   `json:"object"`
	Id          string                   `json:"id"`
	Name        string                   `json:"name"`
	Status      AutomationStatus         `json:"status"`
	CreatedAt   string                   `json:"created_at"`
	UpdatedAt   string                   `json:"updated_at"`
	Steps       []AutomationStepResponse `json:"steps"`
	Connections []AutomationConnection   `json:"connections"`
}

type AutomationConnection struct {
	From string                   `json:"from"`
	To   string                   `json:"to"`
	Type AutomationConnectionType `json:"type,omitempty"`
}

type AutomationConnectionType = string

type AutomationListItem struct {
	Id        string           `json:"id"`
	Name      string           `json:"name"`
	Status    AutomationStatus `json:"status"`
	CreatedAt string           `json:"created_at"`
	UpdatedAt string           `json:"updated_at"`
}

type AutomationRun struct {
	Object      string              `json:"object"`
	Id          string              `json:"id"`
	Status      AutomationRunStatus `json:"status"`
	StartedAt   *string             `json:"started_at"`
	CompletedAt *string             `json:"completed_at"`
	CreatedAt   string              `json:"created_at"`
	Steps       []AutomationRunStep `json:"steps"`
}

type AutomationRunListItem struct {
	Id          string              `json:"id"`
	Status      AutomationRunStatus `json:"status"`
	StartedAt   *string             `json:"started_at"`
	CompletedAt *string             `json:"completed_at"`
	CreatedAt   string              `json:"created_at"`
}

type AutomationRunStatus = string

type AutomationRunStep struct {
	Key         string             `json:"key"`
	Type        AutomationStepType `json:"type"`
	Status      string             `json:"status"`
	StartedAt   *string            `json:"started_at"`
	CompletedAt *string            `json:"completed_at"`
	Output      any                `json:"output"`
	Error       any                `json:"error"`
	CreatedAt   string             `json:"created_at"`
}

type AutomationStatus = string

type AutomationStep struct {
	Key    string             `json:"key"`
	Type   AutomationStepType `json:"type"`
	Config map[string]any     `json:"config"`
}

type AutomationStepResponse struct {
	Key    string             `json:"key"`
	Type   AutomationStepType `json:"type"`
	Config map[string]any     `json:"config"`
}

type AutomationStepType = string

type AutomationsSvc interface {
	CreateWithContext(ctx context.Context, params *CreateAutomationRequest) (CreateAutomationResponse, error)
	Create(params *CreateAutomationRequest) (CreateAutomationResponse, error)
	GetWithContext(ctx context.Context, automationId string) (Automation, error)
	Get(automationId string) (Automation, error)
	ListWithContext(ctx context.Context) (ListAutomationsResponse, error)
	List() (ListAutomationsResponse, error)
	ListWithOptions(ctx context.Context, options *ListAutomationsOptions) (ListAutomationsResponse, error)
	UpdateWithContext(ctx context.Context, automationId string, params *UpdateAutomationRequest) (UpdateAutomationResponse, error)
	Update(automationId string, params *UpdateAutomationRequest) (UpdateAutomationResponse, error)
	RemoveWithContext(ctx context.Context, automationId string) (DeleteAutomationResponse, error)
	Remove(automationId string) (DeleteAutomationResponse, error)
	DuplicateWithContext(ctx context.Context, automationId string) (DuplicateAutomationResponse, error)
	Duplicate(automationId string) (DuplicateAutomationResponse, error)
	StopWithContext(ctx context.Context, automationId string) (StopAutomationResponse, error)
	Stop(automationId string) (StopAutomationResponse, error)
	ListRunsWithContext(ctx context.Context, automationId string, options *ListAutomationRunsOptions) (ListAutomationRunsResponse, error)
	ListRuns(automationId string) (ListAutomationRunsResponse, error)
	GetRunWithContext(ctx context.Context, automationId string, runId string) (AutomationRun, error)
	GetRun(automationId string, runId string) (AutomationRun, error)
}

type AutomationsSvcImpl struct {
	// contains filtered or unexported fields
}

type BatchAddSuppressionsRequest struct {
	Emails []string `json:"emails"`
}

type BatchAddSuppressionsResponse struct {
	Data []AddSuppressionResponse `json:"data"`
}

type BatchEmailResponse struct {
	Data   []SendEmailResponse `json:"data"`
	Errors []BatchError        `json:"errors,omitempty"`
}

type BatchError struct {
	Index   int    `json:"index"`
	Message string `json:"message"`
}

type BatchRemoveSuppressionsRequest struct {
	Emails []string `json:"emails,omitempty"`
	Ids    []string `json:"ids,omitempty"`
}

type BatchRemoveSuppressionsResponse struct {
	Data []RemoveSuppressionResponse `json:"data"`
}

type BatchSendEmailOptions struct {
	IdempotencyKey string `json:"idempotency_key,omitempty"`
	// BatchValidation controls the validation behavior for batch emails.
	// Can be BatchValidationStrict (default) or BatchValidationPermissive.
	// - BatchValidationStrict: Only sends the batch if all emails are valid
	// - BatchValidationPermissive: Processes all emails, allowing partial success
	BatchValidation BatchValidationMode `json:"-"`
}

type BatchSvc interface {
	Send([]*SendEmailRequest) (*BatchEmailResponse, error)
	SendWithContext(ctx context.Context, params []*SendEmailRequest) (*BatchEmailResponse, error)
	SendWithOptions(ctx context.Context, params []*SendEmailRequest, options *BatchSendEmailOptions) (*BatchEmailResponse, error)
}

type BatchSvcImpl struct {
	// contains filtered or unexported fields
}

type BatchValidationMode string

type Broadcast struct {
	Object      string   `json:"object"`
	Id          string   `json:"id"`
	Name        string   `json:"name"`
	SegmentId   string   `json:"segment_id"`
	AudienceId  string   `json:"audience_id"` // Deprecated: Use SegmentId instead
	From        string   `json:"from"`
	Subject     string   `json:"subject"`
	ReplyTo     []string `json:"reply_to"`
	PreviewText string   `json:"preview_text"`
	Status      string   `json:"status"`
	CreatedAt   string   `json:"created_at"`
	ScheduledAt string   `json:"scheduled_at"`
	SentAt      string   `json:"sent_at"`
	Html        string   `json:"html"`
	Text        string   `json:"text"`
	TopicId     *string  `json:"topic_id"` // nil when the broadcast is not scoped to a topic
}

type BroadcastClickedLink struct {
	// Id is an opaque cursor for this row, used only for pagination. It does
	// not identify any entity in Resend.
	Id           string `json:"id"`
	Url          string `json:"url"`
	Clicks       int    `json:"clicks"`
	UniqueClicks int    `json:"unique_clicks"`
}

type BroadcastRecipient struct {
	// Id is an opaque cursor identifying this row, used for pagination. It is not a real entity id.
	Id        string  `json:"id"`
	ContactId *string `json:"contact_id"`
	Email     string  `json:"email"`

	// Count is the number of times this recipient triggered the event. Only present when Type is
	// BroadcastRecipientEventTypeOpened or BroadcastRecipientEventTypeClicked.
	Count int `json:"count,omitempty"`

	// BounceType is only present when Type is BroadcastRecipientEventTypeBounced.
	BounceType BroadcastRecipientBounceType `json:"bounce_type,omitempty"`

	// ClickedLinks is only present when Type is BroadcastRecipientEventTypeClicked.
	ClickedLinks []BroadcastRecipientClickedLink `json:"clicked_links,omitempty"`
}

type BroadcastRecipientBounceType = string

type BroadcastRecipientClickedLink struct {
	Url    string `json:"url"`
	Clicks int    `json:"clicks"`
}

type BroadcastRecipientEventType = string

type BroadcastsSvc interface {
	CreateWithContext(ctx context.Context, params *CreateBroadcastRequest) (CreateBroadcastResponse, error)
	Create(params *CreateBroadcastRequest) (CreateBroadcastResponse, error)

	UpdateWithContext(ctx context.Context, params *UpdateBroadcastRequest) (UpdateBroadcastResponse, error)
	Update(params *UpdateBroadcastRequest) (UpdateBroadcastResponse, error)

	ListWithOptions(ctx context.Context, options *ListOptions) (ListBroadcastsResponse, error)
	ListWithContext(ctx context.Context) (ListBroadcastsResponse, error)
	List() (ListBroadcastsResponse, error)

	ClickedLinksWithOptions(ctx context.Context, broadcastId string, options *ListOptions) (ListBroadcastClickedLinksResponse, error)
	ClickedLinksWithContext(ctx context.Context, broadcastId string) (ListBroadcastClickedLinksResponse, error)
	ClickedLinks(broadcastId string) (ListBroadcastClickedLinksResponse, error)

	GetWithContext(ctx context.Context, broadcastId string) (Broadcast, error)
	Get(broadcastId string) (Broadcast, error)

	SendWithContext(ctx context.Context, params *SendBroadcastRequest) (SendBroadcastResponse, error)
	Send(params *SendBroadcastRequest) (SendBroadcastResponse, error)

	CancelWithContext(ctx context.Context, broadcastId string) (CancelBroadcastResponse, error)
	Cancel(broadcastId string) (CancelBroadcastResponse, error)

	DuplicateWithContext(ctx context.Context, broadcastId string) (DuplicateBroadcastResponse, error)
	Duplicate(broadcastId string) (DuplicateBroadcastResponse, error)

	RemoveWithContext(ctx context.Context, broadcastId string) (RemoveBroadcastResponse, error)
	Remove(broadcastId string) (RemoveBroadcastResponse, error)

	RecipientsWithContext(ctx context.Context, broadcastId string, options *ListBroadcastRecipientsOptions) (ListBroadcastRecipientsResponse, error)
	Recipients(broadcastId string, options *ListBroadcastRecipientsOptions) (ListBroadcastRecipientsResponse, error)
}

type BroadcastsSvcImpl struct {
	// contains filtered or unexported fields
}

type CancelBroadcastResponse struct {
	Object string `json:"object"`
	Id     string `json:"id"`
}

type CancelScheduledEmailResponse struct {
	Id     string `json:"id"`
	Object string `json:"object"`
}

type Client struct {

	// Api Key
	ApiKey string

	// Base URL
	BaseURL *url.URL

	// User agent for client
	UserAgent string

	// Services
	Emails       *EmailsSvcImpl
	Batch        BatchSvc
	ApiKeys      ApiKeysSvc
	Domains      DomainsSvc
	DomainClaims DomainClaimsSvc
	Segments     SegmentsSvc
	// Deprecated: Use Segments instead. Audiences have been renamed to Segments.
	Audiences         AudiencesSvc
	Contacts          *ContactsSvcImpl
	ContactProperties ContactPropertiesSvc
	Broadcasts        BroadcastsSvc
	Templates         TemplatesSvc
	Topics            TopicsSvc
	Webhooks          WebhooksSvc
	Logs              LogsSvc
	Automations       AutomationsSvc
	Events            EventsSvc
	OAuthGrants       OAuthGrantsSvc
	Suppressions      *SuppressionsSvcImpl
	Usage             UsageSvc
	Inboxes           *InboxesSvcImpl
	// contains filtered or unexported fields
}

type Contact struct {
	Id           string                          `json:"id"`
	Email        string                          `json:"email"`
	Object       string                          `json:"object"`
	FirstName    *string                         `json:"first_name"`
	LastName     *string                         `json:"last_name"`
	CreatedAt    string                          `json:"created_at"`
	Unsubscribed bool                            `json:"unsubscribed"`
	Properties   map[string]ContactPropertyValue `json:"properties,omitempty"` // Custom properties for global contacts, returned as {value, type} objects
}

type ContactImport struct {
	Object    string               `json:"object"`
	Id        string               `json:"id"`
	Status    ContactImportStatus  `json:"status"`
	CreatedAt string               `json:"created_at"`
	Counts    *ContactImportCounts `json:"counts,omitempty"`
}

type ContactImportCounts struct {
	Total   int `json:"total"`
	Created int `json:"created"`
	Updated int `json:"updated"`
	Skipped int `json:"skipped"`
	Failed  int `json:"failed"`
}

type ContactImportSegment struct {
	Id string `json:"id"`
}

type ContactImportStatus string

type ContactImportsSvc interface {
	Create(params *CreateContactImportRequest) (CreateContactImportResponse, error)
	CreateWithContext(ctx context.Context, params *CreateContactImportRequest) (CreateContactImportResponse, error)
	Get(id string) (ContactImport, error)
	GetWithContext(ctx context.Context, id string) (ContactImport, error)
	List(options *ListContactImportsOptions) (ListContactImportsResponse, error)
	ListWithContext(ctx context.Context, options *ListContactImportsOptions) (ListContactImportsResponse, error)
}

type ContactImportsSvcImpl struct {
	// contains filtered or unexported fields
}

type ContactPropertiesSvc interface {
	CreateWithContext(ctx context.Context, params *CreateContactPropertyRequest) (CreateContactPropertyResponse, error)
	Create(params *CreateContactPropertyRequest) (CreateContactPropertyResponse, error)
	ListWithOptions(ctx context.Context, options *ListOptions) (ListContactPropertiesResponse, error)
	ListWithContext(ctx context.Context) (ListContactPropertiesResponse, error)
	List() (ListContactPropertiesResponse, error)
	GetWithContext(ctx context.Context, id string) (ContactProperty, error)
	Get(id string) (ContactProperty, error)
	UpdateWithContext(ctx context.Context, params *UpdateContactPropertyRequest) (UpdateContactPropertyResponse, error)
	Update(params *UpdateContactPropertyRequest) (UpdateContactPropertyResponse, error)
	RemoveWithContext(ctx context.Context, id string) (RemoveContactPropertyResponse, error)
	Remove(id string) (RemoveContactPropertyResponse, error)
}

type ContactPropertiesSvcImpl struct {
	// contains filtered or unexported fields
}

type ContactProperty struct {
	Id            string `json:"id"`
	Key           string `json:"key"`
	Object        string `json:"object"`
	CreatedAt     string `json:"created_at"`
	Type          string `json:"type"`
	FallbackValue any    `json:"fallback_value"`
}

type ContactPropertyValue struct {
	Value any    `json:"value"` // string, number, or boolean, depending on Type
	Type  string `json:"type"`
}

type ContactSegmentRef struct {
	Id string `json:"id"`
}

type ContactSegmentsSvc interface {
	AddWithContext(ctx context.Context, params *AddContactSegmentRequest) (AddContactSegmentResponse, error)
	Add(params *AddContactSegmentRequest) (AddContactSegmentResponse, error)
	RemoveWithContext(ctx context.Context, params *RemoveContactSegmentRequest) (RemoveContactSegmentResponse, error)
	Remove(params *RemoveContactSegmentRequest) (RemoveContactSegmentResponse, error)
	ListWithOptions(ctx context.Context, params *ListContactSegmentsRequest, options *ListOptions) (ListContactSegmentsResponse, error)
	ListWithContext(ctx context.Context, params *ListContactSegmentsRequest) (ListContactSegmentsResponse, error)
	List(params *ListContactSegmentsRequest) (ListContactSegmentsResponse, error)
}

type ContactSegmentsSvcImpl struct {
	// contains filtered or unexported fields
}

type ContactTopic struct {
	Id           string `json:"id"`
	Name         string `json:"name"`
	Description  string `json:"description"`
	Subscription string `json:"subscription"`
}

type ContactTopicsSvc interface {
	ListWithOptions(ctx context.Context, id string, options *ListOptions) (ListContactTopicsResponse, error)
	ListWithContext(ctx context.Context, id string) (ListContactTopicsResponse, error)
	List(id string) (ListContactTopicsResponse, error)
	UpdateWithContext(ctx context.Context, params *UpdateContactTopicsRequest) (UpdateContactTopicsResponse, error)
	Update(params *UpdateContactTopicsRequest) (UpdateContactTopicsResponse, error)
}

type ContactTopicsSvcImpl struct {
	// contains filtered or unexported fields
}

type ContactsSvc interface {
	Create(params *CreateContactRequest) (CreateContactResponse, error)
	CreateWithContext(ctx context.Context, params *CreateContactRequest) (CreateContactResponse, error)
	Get(options *GetContactOptions) (Contact, error)
	GetWithContext(ctx context.Context, options *GetContactOptions) (Contact, error)
	List(options *ListContactsOptions) (ListContactsResponse, error)
	ListWithContext(ctx context.Context, options *ListContactsOptions) (ListContactsResponse, error)
	Update(params *UpdateContactRequest) (UpdateContactResponse, error)
	UpdateWithContext(ctx context.Context, params *UpdateContactRequest) (UpdateContactResponse, error)
	Remove(options *RemoveContactOptions) (RemoveContactResponse, error)
	RemoveWithContext(ctx context.Context, options *RemoveContactOptions) (RemoveContactResponse, error)
}

type ContactsSvcImpl struct {
	Topics     ContactTopicsSvc
	Segments   ContactSegmentsSvc
	Properties ContactPropertiesSvc
	Imports    ContactImportsSvc
	// contains filtered or unexported fields
}

type CreateApiKeyRequest struct {
	Name       string `json:"name"`
	Permission string `json:"permission,omitempty"` // TODO: update permission to type
	DomainId   string `json:"domain_id,omitempty"`
}

type CreateApiKeyResponse struct {
	Id    string `json:"id"`
	Token string `json:"token"`
}

type CreateAudienceRequest = CreateSegmentRequest

type CreateAutomationRequest struct {
	Name        string                 `json:"name"`
	Status      AutomationStatus       `json:"status,omitempty"`
	Steps       []AutomationStep       `json:"steps"`
	Connections []AutomationConnection `json:"connections"`
}

type CreateAutomationResponse struct {
	Object string `json:"object"`
	Id     string `json:"id"`
}

type CreateBroadcastRequest struct {
	SegmentId  string   `json:"segment_id,omitempty"`
	AudienceId string   `json:"audience_id,omitempty"` // Deprecated: Use SegmentId instead
	From       string   `json:"from,omitempty"`
	Subject    string   `json:"subject,omitempty"`
	ReplyTo    []string `json:"reply_to,omitempty"`
	Html       string   `json:"html,omitempty"`
	Text       string   `json:"text,omitempty"`
	Name       string   `json:"name,omitempty"`

	// Preview text shown in the recipient's inbox, usually next to or below the subject line.
	PreviewText string `json:"preview_text,omitempty"`

	// The ID of the topic the broadcast is scoped to. When omitted, the broadcast is sent to
	// every subscribed contact in the segment, without checking topic preferences.
	TopicId string `json:"topic_id,omitempty"`

	// Send the broadcast immediately upon creation instead of creating a draft.
	Send bool `json:"send,omitempty"`

	// Schedule email to be sent later. The date should be in natural language (e.g.: in 1 min)
	// or ISO 8601 format (e.g: 2024-08-05T11:52:01.858Z).
	// Only valid when Send is true.
	ScheduledAt string `json:"scheduled_at,omitempty"`
}

type CreateBroadcastResponse struct {
	Id string `json:"id"`
}

type CreateContactImportRequest struct {
	// CSV file content (required). Maximum size is 50MB.
	File []byte
	// Filename to use in the multipart upload. Defaults to "import.csv".
	Filename string
	// ColumnMap maps contact fields to CSV column names.
	// Will be JSON-encoded before sending.
	// Example: map[string]any{"email": "Email", "first_name": "First Name"}
	ColumnMap map[string]any
	// OnConflict strategy: "upsert" or "skip" (default "skip").
	OnConflict string
	// Segments is a list of segment objects to add imported contacts to.
	// Example: []ContactImportSegment{{Id: "60a2ac5e-0774-456e-817d-ebf40f6dba31"}}
	Segments []ContactImportSegment
	// Topics is a list of topic subscriptions to apply to imported contacts.
	// Will be JSON-encoded as [{"id": "...", "subscription": "opt_in|opt_out"}] before sending.
	Topics []TopicSubscriptionUpdate
}

type CreateContactImportResponse struct {
	Object string `json:"object"`
	Id     string `json:"id"`
}

type CreateContactPropertyRequest struct {
	Key           string `json:"key"`
	Type          string `json:"type"`
	FallbackValue any    `json:"fallback_value"`
}

type CreateContactPropertyResponse struct {
	Id     string `json:"id"`
	Object string `json:"object"`
}

type CreateContactRequest struct {
	Email        string `json:"email"`
	AudienceId   string `json:"audience_id,omitempty"` // Deprecated: Optional, use Segments API for contact organization
	Unsubscribed bool   `json:"unsubscribed,omitempty"`
	FirstName    string `json:"first_name,omitempty"`
	LastName     string `json:"last_name,omitempty"`
	// Properties are custom key-value pairs for global contacts (when audience_id is omitted).
	// NOTE: Currently, the Resend API only accepts string values for properties.
	// Non-string values (numbers, booleans, etc.) will be rejected by the API with a validation error.
	// Example: Properties: map[string]any{"tier": "premium", "age": "30", "active": "true"}
	Properties map[string]any `json:"properties,omitempty"`
	// Segments is an array of segment IDs to add the contact to (when audience_id is omitted).
	// This field is only used when AudienceId is not set.
	Segments []ContactSegmentRef `json:"segments,omitempty"`
	// Topics is an array of topic subscriptions for the contact (when audience_id is omitted).
	// This field is only used when AudienceId is not set.
	Topics []TopicSubscriptionUpdate `json:"topics,omitempty"`
}

type CreateContactResponse struct {
	Object string `json:"object"`
	Id     string `json:"id"`
}

type CreateDomainClaimRequest struct {
	Name              string `json:"name"`
	Region            string `json:"region,omitempty"`
	CustomReturnPath  string `json:"custom_return_path,omitempty"`
	TrackingSubdomain string `json:"tracking_subdomain,omitempty"`
	OpenTracking      *bool  `json:"open_tracking,omitempty"`
	ClickTracking     *bool  `json:"click_tracking,omitempty"`
}

type CreateDomainRequest struct {
	Name              string              `json:"name"`
	Region            string              `json:"region,omitempty"`
	CustomReturnPath  string              `json:"custom_return_path,omitempty"`
	TrackingSubdomain string              `json:"tracking_subdomain,omitempty"`
	OpenTracking      *bool               `json:"open_tracking,omitempty"`
	ClickTracking     *bool               `json:"click_tracking,omitempty"`
	Capabilities      *DomainCapabilities `json:"capabilities,omitempty"`
}

type CreateDomainResponse struct {
	Id                string              `json:"id"`
	Name              string              `json:"name"`
	CreatedAt         string              `json:"created_at"`
	Status            string              `json:"status"`
	Records           []Record            `json:"records"`
	Region            string              `json:"region"`
	DnsProvider       string              `json:"dnsProvider"`
	OpenTracking      bool                `json:"open_tracking,omitempty"`
	ClickTracking     bool                `json:"click_tracking,omitempty"`
	TrackingSubdomain string              `json:"tracking_subdomain,omitempty"`
	Capabilities      *DomainCapabilities `json:"capabilities,omitempty"`
}

type CreateEventRequest struct {
	Name   string            `json:"name"`
	Schema map[string]string `json:"schema,omitempty"`
}

type CreateEventResponse struct {
	Object string `json:"object"`
	Id     string `json:"id"`
}

type CreateInboxDraftOptions struct {
	// IdempotencyKey is a unique key for the request, so the draft is created only once. 1 to 256
	// characters. A retry with the same key within 24 hours returns the first successful (2xx)
	// response, with the `idempotent-replayed: true` header. A failed request is not stored, so it
	// can be retried with the same key. Reusing the key with a different body, or while the first
	// request is still running, returns a 409.
	// https://resend.com/docs/dashboard/emails/idempotency-keys
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

type CreateInboxDraftRequest struct {
	// To holds the recipients. Each value can include a friendly name, for example
	// `Ada Lovelace <ada@example.org>`. A nil slice is omitted, so a reply draft is addressed to
	// the sender of the email it replies to, or to its Reply-To when set. For an email the inbox
	// sent, it defaults to that email's `to` recipients. An empty, non-nil slice leaves it empty.
	To  []string
	Cc  []string
	Bcc []string
	// Subject is max 2000 characters. A string that is only whitespace, or that contains a line
	// break, is rejected.
	Subject string
	Html    string
	Text    string
	// Attachments are files to store on the draft. Each one needs a Filename and either Content
	// with a ContentType, or a Path URL that is downloaded when the request is made. The files on a
	// draft, downloaded ones included, can total at most 25 MB. An empty file, a blocked file type,
	// or a Path that cannot be downloaded returns a 422.
	Attachments []*InboxDraftAttachmentInput
	// ThreadId is the thread ID to reply in. It must be sent with ReplyToEmailId.
	ThreadId string
	// ReplyToEmailId is the email ID to reply to, as returned in Data[].Id by
	// Threads.Emails.List. It must be sent with ThreadId.
	ReplyToEmailId string
}

type CreateInboxDraftResponse struct {
	Object string `json:"object"`
	Id     string `json:"id"`
}

type CreateInboxLabelRequest struct {
	// Name of the label. Max 64 characters. The API trims it. It must not match another label on
	// the inbox, compared without case.
	Name string `json:"name"`
	// Color of the label, as a `#RRGGBB` hex color. It is stored in uppercase. When omitted, a
	// random color from the dashboard palette is used.
	Color string `json:"color,omitempty"`
}

type CreateInboxLabelResponse struct {
	Object string `json:"object"`
	Id     string `json:"id"`
}

type CreateInboxRequest struct {
	// EmailAddress is the inbox address on one of your domains. The API trims and lowercases it.
	EmailAddress string `json:"email_address"`
	// Name is the internal name for the inbox. Recipients do not see it. Max 64 characters.
	// Defaults to EmailAddress.
	Name string `json:"name,omitempty"`
	// FromName is the name recipients see when mail is sent from this inbox. A plain name, not a
	// `Name <email>` address. Max 78 characters.
	FromName string `json:"from_name,omitempty"`
	// Forwarding makes Resend provision a receiving address, so you can receive mail without adding
	// an MX record. The address is returned in ReceivingAddress.
	Forwarding bool `json:"forwarding,omitempty"`
}

type CreateInboxResponse struct {
	Object string `json:"object"`
	Id     string `json:"id"`
}

type CreateSegmentRequest struct {
	Name string `json:"name"`
}

type CreateSegmentResponse struct {
	Id     string `json:"id"`
	Name   string `json:"name"`
	Object string `json:"object"`
}

type CreateTemplateRequest struct {
	Name      string              `json:"name"`
	Alias     string              `json:"alias,omitempty"`
	From      string              `json:"from,omitempty"`
	Subject   string              `json:"subject,omitempty"`
	ReplyTo   any                 `json:"reply_to,omitempty"` // string or []string
	Html      string              `json:"html"`
	Text      string              `json:"text,omitempty"`
	Variables []*TemplateVariable `json:"variables,omitempty"`
}

type CreateTemplateResponse struct {
	Id     string `json:"id"`
	Object string `json:"object"`
}

type CreateTopicRequest struct {
	Name                string              `json:"name"`
	DefaultSubscription DefaultSubscription `json:"default_subscription"`
	Description         string              `json:"description,omitempty"`
}

type CreateTopicResponse struct {
	Id string `json:"id"`
}

type CreateWebhookRequest struct {
	Endpoint string   `json:"endpoint"`
	Events   []string `json:"events"`
}

type CreateWebhookResponse struct {
	Object        string `json:"object"`
	Id            string `json:"id"`
	SigningSecret string `json:"signing_secret"`
}

type DefaultError struct {
	Message string `json:"message"`
}

type DefaultSubscription string

type DeleteAutomationResponse struct {
	Object  string `json:"object"`
	Id      string `json:"id"`
	Deleted bool   `json:"deleted"`
}

type DeleteEventResponse struct {
	Object  string `json:"object"`
	Id      string `json:"id"`
	Deleted bool   `json:"deleted"`
}

type DeleteWebhookResponse struct {
	Object  string `json:"object"`
	Id      string `json:"id"`
	Deleted bool   `json:"deleted"`
}

type Domain struct {
	Id                string              `json:"id,omitempty"`
	Object            string              `json:"object,omitempty"`
	Name              string              `json:"name,omitempty"`
	CreatedAt         string              `json:"created_at,omitempty"`
	Status            string              `json:"status,omitempty"`
	Region            string              `json:"region,omitempty"`
	Records           []Record            `json:"records,omitempty"`
	OpenTracking      bool                `json:"open_tracking,omitempty"`
	ClickTracking     bool                `json:"click_tracking,omitempty"`
	TrackingSubdomain string              `json:"tracking_subdomain,omitempty"`
	Capabilities      *DomainCapabilities `json:"capabilities,omitempty"`
}

type DomainCapabilities struct {
	Sending   DomainCapabilityStatus `json:"sending,omitempty"`
	Receiving DomainCapabilityStatus `json:"receiving,omitempty"`
}

type DomainCapabilityStatus = string

type DomainClaim struct {
	Object        string             `json:"object,omitempty"`
	Id            string             `json:"id,omitempty"`
	Name          string             `json:"name,omitempty"`
	Status        DomainClaimStatus  `json:"status,omitempty"`
	DomainId      string             `json:"domain_id,omitempty"`
	Region        string             `json:"region,omitempty"`
	Record        *DomainClaimRecord `json:"record,omitempty"`
	BlockedReason string             `json:"blocked_reason,omitempty"`
	FailureReason string             `json:"failure_reason,omitempty"`
	CreatedAt     string             `json:"created_at,omitempty"`
	ExpiresAt     string             `json:"expires_at,omitempty"`
}

type DomainClaimBlockedReason = string

type DomainClaimRecord struct {
	Type  string `json:"type,omitempty"`
	Name  string `json:"name,omitempty"`
	Value string `json:"value,omitempty"`
	Ttl   string `json:"ttl,omitempty"`
}

type DomainClaimStatus = string

type DomainClaimsSvc interface {
	Create(params *CreateDomainClaimRequest) (DomainClaim, error)
	CreateWithContext(ctx context.Context, params *CreateDomainClaimRequest) (DomainClaim, error)
	Get(domainId string) (DomainClaim, error)
	GetWithContext(ctx context.Context, domainId string) (DomainClaim, error)
	Verify(domainId string) (DomainClaim, error)
	VerifyWithContext(ctx context.Context, domainId string) (DomainClaim, error)
}

type DomainClaimsSvcImpl struct {
	// contains filtered or unexported fields
}

type DomainRecordStatus = string

type DomainStatus = string

type DomainsSvc interface {
	CreateWithContext(ctx context.Context, params *CreateDomainRequest) (CreateDomainResponse, error)
	Create(params *CreateDomainRequest) (CreateDomainResponse, error)
	VerifyWithContext(ctx context.Context, domainId string) (bool, error)
	Verify(domainId string) (bool, error)
	ListWithOptions(ctx context.Context, options *ListOptions) (ListDomainsResponse, error)
	ListWithContext(ctx context.Context) (ListDomainsResponse, error)
	List() (ListDomainsResponse, error)
	GetWithContext(ctx context.Context, domainId string) (Domain, error)
	Get(domainId string) (Domain, error)
	RemoveWithContext(ctx context.Context, domainId string) (bool, error)
	Remove(domainId string) (bool, error)
	UpdateWithContext(ctx context.Context, domainId string, params *UpdateDomainRequest) (Domain, error)
	Update(domainId string, params *UpdateDomainRequest) (Domain, error)
}

type DomainsSvcImpl struct {
	// contains filtered or unexported fields
}

type DuplicateAutomationResponse struct {
	Object string `json:"object"`
	Id     string `json:"id"`
}

type DuplicateBroadcastResponse struct {
	Object string `json:"object"`
	Id     string `json:"id"`
}

type DuplicateTemplateResponse struct {
	Id     string `json:"id"`
	Object string `json:"object"`
}

type Email struct {
	Id        string   `json:"id"`
	Object    string   `json:"object"`
	MessageId string   `json:"message_id"`
	To        []string `json:"to"`
	From      string   `json:"from"`
	CreatedAt string   `json:"created_at"`
	Subject   string   `json:"subject"`
	Html      string   `json:"html"`
	Text      string   `json:"text"`
	Bcc       []string `json:"bcc"`
	Cc        []string `json:"cc"`
	ReplyTo   []string `json:"reply_to"`
	LastEvent string   `json:"last_event"`
}

type EmailAttachment struct {
	Object             string `json:"object,omitempty"`
	Id                 string `json:"id"`
	Filename           string `json:"filename"`
	ContentType        string `json:"content_type"`
	ContentDisposition string `json:"content_disposition"`
	ContentId          string `json:"content_id"`
	DownloadUrl        string `json:"download_url"`
	ExpiresAt          string `json:"expires_at"`
}

type EmailTemplate struct {
	// Id is the template ID or alias to use for this email
	Id string `json:"id"`
	// Variables are the key-value pairs to populate the template placeholders
	Variables map[string]any `json:"variables,omitempty"`
}

type EmailsSvc interface {
	CancelWithContext(ctx context.Context, emailId string) (*CancelScheduledEmailResponse, error)
	Cancel(emailId string) (*CancelScheduledEmailResponse, error)
	ShareWithContext(ctx context.Context, emailId string, params *ShareEmailRequest) (*ShareEmailResponse, error)
	Share(emailId string, params *ShareEmailRequest) (*ShareEmailResponse, error)
	UpdateWithContext(ctx context.Context, params *UpdateEmailRequest) (*UpdateEmailResponse, error)
	Update(params *UpdateEmailRequest) (*UpdateEmailResponse, error)
	SendWithOptions(ctx context.Context, params *SendEmailRequest, options *SendEmailOptions) (*SendEmailResponse, error)
	SendWithContext(ctx context.Context, params *SendEmailRequest) (*SendEmailResponse, error)
	Send(params *SendEmailRequest) (*SendEmailResponse, error)
	GetWithContext(ctx context.Context, emailId string) (*Email, error)
	Get(emailId string) (*Email, error)

	// Both List and ListWithOptions do the same thing, but since these List methods
	// were introduced after some time, we kept both for overall consistency with
	// the rest of the packages.
	ListWithOptions(ctx context.Context, options *ListOptions) (ListEmailsResponse, error)
	ListWithContext(ctx context.Context) (ListEmailsResponse, error)
	List() (ListEmailsResponse, error)

	// Attachment methods for sent emails
	GetAttachmentWithContext(ctx context.Context, emailId string, attachmentId string) (*EmailAttachment, error)
	GetAttachment(emailId string, attachmentId string) (*EmailAttachment, error)
	ListAttachmentsWithOptions(ctx context.Context, emailId string, options *ListOptions) (ListEmailAttachmentsResponse, error)
	ListAttachmentsWithContext(ctx context.Context, emailId string) (ListEmailAttachmentsResponse, error)
	ListAttachments(emailId string) (ListEmailAttachmentsResponse, error)

	// Metrics methods
	MetricsWithOptions(ctx context.Context, options *MetricsOptions) (*MetricsResponse, error)
	MetricsWithContext(ctx context.Context) (*MetricsResponse, error)
	Metrics() (*MetricsResponse, error)
}

type EmailsSvcImpl struct {
	Receiving ReceivingSvc
	// contains filtered or unexported fields
}

type Event struct {
	Object    string            `json:"object"`
	Id        string            `json:"id"`
	Name      string            `json:"name"`
	Schema    map[string]string `json:"schema"`
	CreatedAt string            `json:"created_at"`
	UpdatedAt *string           `json:"updated_at"`
}

type EventSchemaType = string

type EventSummary struct {
	Id        string            `json:"id"`
	Name      string            `json:"name"`
	Schema    map[string]string `json:"schema"`
	CreatedAt string            `json:"created_at"`
	UpdatedAt *string           `json:"updated_at"`
}

type EventsSvc interface {
	CreateWithContext(ctx context.Context, params *CreateEventRequest) (CreateEventResponse, error)
	Create(params *CreateEventRequest) (CreateEventResponse, error)
	GetWithContext(ctx context.Context, identifier string) (Event, error)
	Get(identifier string) (Event, error)
	ListWithContext(ctx context.Context) (ListEventsResponse, error)
	List() (ListEventsResponse, error)
	ListWithOptions(ctx context.Context, options *ListOptions) (ListEventsResponse, error)
	UpdateWithContext(ctx context.Context, identifier string, params *UpdateEventRequest) (UpdateEventResponse, error)
	Update(identifier string, params *UpdateEventRequest) (UpdateEventResponse, error)
	RemoveWithContext(ctx context.Context, identifier string) (DeleteEventResponse, error)
	Remove(identifier string) (DeleteEventResponse, error)
	SendWithContext(ctx context.Context, params *SendEventRequest) (SendEventResponse, error)
	Send(params *SendEventRequest) (SendEventResponse, error)
}

type EventsSvcImpl struct {
	// contains filtered or unexported fields
}

type ForwardInboxThreadEmailOptions struct {
	// IdempotencyKey is a unique key for the request, so the forward is sent only once. 1 to 256
	// characters. A retry with the same key within 24 hours returns the first successful (2xx)
	// response, with the `idempotent-replayed: true` header. A failed request is not stored, so it
	// can be retried with the same key. Reusing the key with a different body, or while the first
	// request is still running, returns a 409.
	// https://resend.com/docs/dashboard/emails/idempotency-keys
	IdempotencyKey string `json:"idempotency_key,omitempty"`
}

type ForwardInboxThreadEmailRequest struct {
	// To holds the recipients. It must name at least one address. To, Cc and Bcc combined cannot
	// exceed 50 recipients.
	To []string `json:"to"`
	// Cc holds CC recipients. They count toward the 50-recipient limit.
	Cc []string `json:"cc,omitempty"`
	// Bcc holds BCC recipients. They count toward the 50-recipient limit.
	Bcc []string `json:"bcc,omitempty"`
	// Html is an HTML note sent above the quoted original.
	Html string `json:"html,omitempty"`
	// Text is a plain-text note sent above the quoted original.
	Text string `json:"text,omitempty"`
	// Subject of the forward. It cannot contain a line break. When omitted, the thread subject is
	// used, prefixed with `Fwd:` if it does not already start with it.
	Subject string `json:"subject,omitempty"`
	// Attachments are files to attach, as on Emails.Send. Each one needs Content or Path. They
	// share one limit with the attachments of the original message, which the forward also sends.
	// Together they can have at most 25 MB of Content. A Path file does not count toward the 25
	// MB, because it is fetched when the email is sent. An empty file, a
	// blocked file type, or a Path that is not an http or https URL or that points to localhost
	// returns a 422.
	Attachments []*Attachment `json:"attachments,omitempty"`
	// Headers are custom headers to add to the email. The In-Reply-To, References and Reply-To
	// headers are set by Resend and cannot be set here. Sending one of them, in any letter case,
	// returns a 422. Header names cannot be empty, and names and values cannot contain line breaks
	// or null characters, or the request returns a 422.
	Headers map[string]string `json:"headers,omitempty"`
}

type ForwardInboxThreadEmailResponse struct {
	// Id is the ID of the sent email. Use it with the emails methods.
	Id string `json:"id"`
}

type GetContactOptions struct {
	AudienceId string // Optional - omit for global contacts
	Id         string // Required - can be contact ID or email address
}

type GetReceivedEmailParams struct {
	HtmlFormat *string
}

type Inbox struct {
	Object string `json:"object"`
	Id     string `json:"id"`
	// Name is the internal name for the inbox. Recipients do not see it. Falls back to the inbox
	// email address.
	Name         string `json:"name"`
	EmailAddress string `json:"email_address"`
	DomainId     string `json:"domain_id"`
	// ReceivingAddress is the address to forward mail to when forwarding is enabled. nil otherwise.
	ReceivingAddress *string `json:"receiving_address"`
	// FromName is the name recipients see when mail is sent from this inbox. nil when not set.
	FromName *string `json:"from_name"`
	// Unread is the number of unread threads in the Inbox folder.
	Unread int `json:"unread"`
	// Drafts is the number of unsent drafts.
	Drafts int `json:"drafts"`
	// LastReceived is the timestamp of the newest received email in the Inbox folder. nil when the
	// folder has no received email.
	LastReceived *string `json:"last_received"`
	CreatedAt    string  `json:"created_at"`
	UpdatedAt    string  `json:"updated_at"`
}

type InboxAgent struct {
	Object string `json:"object"`
	// Instructions the agent follows when it handles the threads of the inbox. nil when no
	// instructions are set.
	Instructions *string `json:"instructions"`
	// Tone the agent writes in. nil when no tone is set.
	Tone *InboxAgentTone `json:"tone"`
	// Actions are the actions the agent can take. Empty when no actions are enabled.
	Actions []InboxAgentAction `json:"actions"`
}

type InboxAgentAction = string

type InboxAgentSvc interface {
	Get(inboxId string) (InboxAgent, error)
	GetWithContext(ctx context.Context, inboxId string) (InboxAgent, error)
	Update(inboxId string, params *UpdateInboxAgentRequest) (UpdateInboxAgentResponse, error)
	UpdateWithContext(ctx context.Context, inboxId string, params *UpdateInboxAgentRequest) (UpdateInboxAgentResponse, error)
}

type InboxAgentSvcImpl struct {
	// contains filtered or unexported fields
}

type InboxAgentTone = string

type InboxDraft struct {
	Object string `json:"object"`
	Id     string `json:"id"`
	// Type is reply when the draft replies to an email in an existing thread, and standalone when
	// the draft starts a new thread.
	Type InboxDraftType `json:"type"`
	// To holds the recipients. nil or empty when no recipients are set.
	To      []string `json:"to"`
	Cc      []string `json:"cc"`
	Bcc     []string `json:"bcc"`
	Subject *string  `json:"subject"`
	Html    *string  `json:"html"`
	// Text is the plain text body. A reply draft created without a body has an empty string.
	Text *string `json:"text"`
	// ThreadId is the thread ID when the draft is a reply. nil otherwise.
	ThreadId *string `json:"thread_id"`
	// ReplyToEmailId is the email ID the draft replies to. nil otherwise.
	ReplyToEmailId *string `json:"reply_to_email_id"`
	// EmailId is the ID of the outbound email queued when the draft was sent. nil until the draft
	// is sent.
	EmailId   *string `json:"email_id"`
	CreatedAt string  `json:"created_at"`
	UpdatedAt string  `json:"updated_at"`
	// Attachments holds the files stored on the draft.
	Attachments []InboxDraftAttachment `json:"attachments"`
}

type InboxDraftAttachment struct {
	Id          string `json:"id"`
	Filename    string `json:"filename"`
	ContentType string `json:"content_type"`
	// Size is the size of the attachment in bytes.
	Size int `json:"size"`
}

type InboxDraftAttachmentInput struct {
	// Content is the content of the file. It is sent encoded in base64 and cannot be empty.
	Content []byte `json:"content,omitempty"`
	// Path is a URL to download the file from, starting with http or https. A file that cannot be
	// downloaded returns a 422, and so does a request whose downloads take more than 20 seconds
	// together.
	Path string `json:"path,omitempty"`
	// Filename of the attachment. A blocked file type returns a 422.
	Filename string `json:"filename"`
	// ContentType is the MIME type of the attachment. It is required with Content. With Path, it
	// defaults to the content type of the downloaded file.
	ContentType string `json:"content_type,omitempty"`
}

type InboxDraftListItem struct {
	Id      string         `json:"id"`
	Type    InboxDraftType `json:"type"`
	To      []string       `json:"to"`
	Cc      []string       `json:"cc"`
	Bcc     []string       `json:"bcc"`
	Subject *string        `json:"subject"`
	// Snippet is a short preview of the body.
	Snippet        *string `json:"snippet"`
	ThreadId       *string `json:"thread_id"`
	ReplyToEmailId *string `json:"reply_to_email_id"`
	UpdatedAt      string  `json:"updated_at"`
	// Attachments holds the files stored on the draft.
	Attachments []InboxDraftAttachment `json:"attachments"`
}

type InboxDraftType = string

type InboxDraftsSvc interface {
	List(inboxId string, options *ListOptions) (ListInboxDraftsResponse, error)
	ListWithContext(ctx context.Context, inboxId string, options *ListOptions) (ListInboxDraftsResponse, error)
	Create(inboxId string, params *CreateInboxDraftRequest) (CreateInboxDraftResponse, error)
	CreateWithContext(ctx context.Context, inboxId string, params *CreateInboxDraftRequest) (CreateInboxDraftResponse, error)
	CreateWithOptions(ctx context.Context, inboxId string, params *CreateInboxDraftRequest, options *CreateInboxDraftOptions) (CreateInboxDraftResponse, error)
	Get(inboxId, draftId string) (InboxDraft, error)
	GetWithContext(ctx context.Context, inboxId, draftId string) (InboxDraft, error)
	Update(inboxId, draftId string, params *UpdateInboxDraftRequest) (UpdateInboxDraftResponse, error)
	UpdateWithContext(ctx context.Context, inboxId, draftId string, params *UpdateInboxDraftRequest) (UpdateInboxDraftResponse, error)
	Remove(inboxId, draftId string) (RemoveInboxDraftResponse, error)
	RemoveWithContext(ctx context.Context, inboxId, draftId string) (RemoveInboxDraftResponse, error)
	Send(inboxId, draftId string, params *SendInboxDraftRequest) (SendInboxDraftResponse, error)
	SendWithContext(ctx context.Context, inboxId, draftId string, params *SendInboxDraftRequest) (SendInboxDraftResponse, error)
	SendWithOptions(ctx context.Context, inboxId, draftId string, params *SendInboxDraftRequest, options *SendInboxDraftOptions) (SendInboxDraftResponse, error)
}