How-to

Send with a final recipient

Applies to: .NET SDK Last updated: 2026-06-11

Goal

Send a message to a relay agent with a claim about who the message is ultimately for.

Code

string envelope = await client.EncryptEnvelopeAsync(
    recipient:      "relay-agent.acme.com",   // who decrypts first
    body:           "hello alice",
    finalRecipient: "[email protected]");      // intended end recipient

When the relay agent decrypts, msg.FinalRecipient contains the value you set. The relay can then forward using Forward a message to a final recipient.

See also