GRgrowsurf
Participants

Create mobile participant token

Changed on

Creates or returns a participant using the same input behavior as Add Participant, then returns a participant-scoped token for GrowSurf mobile SDK participant endpoints. Use this endpoint from your backend after your mobile app authenticates a signed-in user. The program must have mobile SDK access enabled.

post/campaign/{id}/mobile-participant-token

Request

Path parameters

idstring required

GrowSurf program ID.

Request body

emailstring email required
referredBystring

Referrer participant ID or email address.

referralStatus'CREDIT_PENDING' | 'CREDIT_AWARDED'
firstNamestring
lastNamestring
ipAddressstring
fingerprintstring
mobileInstanceIdstring

Optional app-install scoped identifier for native mobile anti-fraud. Recommended for mobile participant creation and mobile participant token flows. The official mobile SDKs generate this as a lowercase UUID.

metadataMetadata

Shallow custom metadata object.

Response

Participant and mobile participant token returned.

participantTokenstring required

Participant-scoped bearer token for GrowSurf mobile SDK participant endpoints.

expiresIninteger required

Token lifetime in seconds.

isNewboolean required

Whether this request created a new participant. Returns false when the participant already existed.

Changes

  • 26f06e273394Revision changes
    • info

      added the optional property / to the response with the status

  • 5315da9cd1a6Revision changes
    • info

      added the new optional request property

    • info

      added the optional property / to the response with the status