Dashboard

The truConsent dashboard provides a Consent Link page where you can generate links without any code.

---

Generate a link

1. Open the Consent Link page

   In the sidebar, navigate to Consent Link.

2. Select an asset

   Choose the asset whose collection points you want to present to the data principal.

3. Select a collection point

   Only active collection points for the selected asset appear in the list.

4. Enter the phone number

   Use E.164 format (e.g., +919876543210). A plain 10-digit number is automatically prefixed with +91.

5. Set the expiry

   Choose how many hours the link should remain valid (1–24 hours, default 24).

6. Generate

   Click Generate Consent Link. The link and its metadata (request ID, event ID, expiry time) appear on the right panel. Use the copy button to copy the URL, then send it to the data principal.

---

View history

To review previously generated links and track their completion status, click View History in the top-right corner of the Consent Link page.

The history table shows each link’s collection point, masked phone number, creation time, and status:

Status	Meaning
Active	The link is valid and has not yet been used.
Completed	The data principal opened the link and submitted the consent form (is_completed = true).
Expired	The link’s expiry time has passed without being completed.

---

Troubleshooting

Link shows as expired

• Links are valid for a maximum of 24 hours. Check the expires_at field in the create response.
• Verify the event_id in the URL matches the one returned at creation time.

OTP is not delivered to the data principal

• Confirm the phone number is in E.164 format (e.g., +919876543210).
• Check your organization’s SMS provider configuration in Settings.

Email delivery failed

• The delivery_status.email value will be "failed" if sending was attempted but failed.
• Verify the address is valid and your email provider is configured in Settings.

400 Asset / Collection Point mismatch

• The collection_point_id you provided does not belong to the asset_id. Fetch the correct collection points for your asset first — see Get collection point.

401 Unauthorized

• Confirm your Authorization header is set to Bearer <token> with a valid session token.
• Session tokens expire — re-authenticate if the token is stale.

403 Forbidden

• Verify X-Org-Id matches an organization you belong to.
• For the history endpoint, your role must have access to the collection-points module.

---

← View link history