About Identity Envelopes

Learn what identity envelopes are.

  • An Identity envelope is a secure and encrypted structure containing RampIDs and metadata. You create encrypted envelopes from RampIDs to add a layer of obfuscation and enable secure RampID transfer through the programmatic bidstream.
  • Each envelope is created with a client-specific encryption key that makes it unique.
  • An envelope is valid for 15 days from the date of creation.
  • An envelope is represented as a Base64-encoded string.

For more information, see "Identity Envelopes" in the Identity help.

Identity envelope string example

AY3SYJlFDI1RqsMv9gZOjOab6hGuwWKmbE4K70Z-Zex27DD6M9U0Jg

Randomization ensures the string is different each time an envelope is created for the same underlying data.

Responses

The success response for a batch request should match the success response for a single transaction request.

A 400 error will look like the following example:

{
	"code": 400,
	"document": {
		"error": {
			"message": "Envelope error: ENVELOPE_EXPIRED",
			"code": "600-0116",
			"requestId": "123456789987654321"
		}
	}
}