Skip to main content

Accessing participant id and external identifier

Updated this week

getParticipant()

getParticipant() is a scripting function that gives you access to the current participant’s system ID and any external identifiers (like an Amazon ID or Rival ID) that are stored on their profile. E
It is read‑only – you can fetch information but you cannot edit it.

This function takes no input parameters

Function Signature

 participant = getParticipant();

Output

getParticipant() returns an object that contains participant’s ID and an identifier object with key‑value pairs for each configured external identifier.

{
participantId: "p_123456",
identifier: {
Rival: "rival_4455",
amazon: "amz_9988"
}
}

Example

p = getParticipant()
ref_id = p.participantId
amazon_id = p.identifier.amazon
rival_id = p.idenitfier.Rival

When accessing an external identifier (e.g., p.identifier.amazon), the key must match exactly the source name of the external identifier configured in Rival. For example, if the external identifier source is named AmazonID, you must use p.identifier.AmazonID (not p.identifier.amazonid or p.identifier.amazon).

Did this answer your question?