Forwarding Emails

Use Client.Forward when you want to hand an inbound email off to someone who wasn't on the original thread, rather than replying to the sender. Reach for this instead of Client.Reply whenever the new recipient needs the original message content but isn't part of the existing conversation.

Under the hood, Forward is not a distinct API operation: it builds a SendParams value from the ReceivedEmail and calls Client.Send, so a forward is really a synthesized outbound send. See Sending Emails for the underlying delivery semantics (wait mode, idempotency).

What you need before forwarding#

• A *primitive.Client constructed with primitive.NewClient.
• A *primitive.ReceivedEmail from primitive.Receive or ReceiveFromHTTPRequest.
• The recipient address for the forward.

Forward an inbound email#

1. 1

   Call Client.Forward with the inbound email and a recipient#

   Pass the *ReceivedEmail you received and a ForwardParams with at least To:

   package main
   
   import (
   	"context"
   	"log"
   
   	primitive "github.com/primitivedotdev/sdks/sdk-go"
   )
   
   func handleForward(ctx context.Context, client *primitive.Client, email *primitive.ReceivedEmail) {
   	result, err := client.Forward(ctx, email, primitive.ForwardParams{
   		To:       "ops@example.com",
   		BodyText: "Can you take this one?",
   	})
   	if err != nil {
   		log.Printf("forward failed: %v", err)
   		return
   	}
   	log.Println(result.ID, result.Status)
   }
   

2. 2

   Read the generated forwarded-message body#

   Forward prepends your BodyText (when set) to a generated block, then appends the original email's headers and text body:

   Can you take this one?
   
   ---------- Forwarded message ----------
   From: Alice <alice@example.com>
   To: support@example.com
   Subject: Order question
   Date: Tue, 14 Dec 2025 11:59:50 +0000
   Message-ID: <abc123@example.com>
   
   <original email text>
   

   The Date line only appears when the inbound email's headers included one; Message-ID only appears when the inbound thread had one.

3. 3

   Verify delivery#

   Forward returns the same SendResult shape as Send: check result.Status and, when you cared enough to opt into wait mode, result.DeliveryStatus. Forward has no Wait option of its own, see the note below.

ForwardParams fields#

Next steps#