🧭 Navigating Roles and Permissions

This guide walks through how to use the Roles tab in Members and Roles: list roles, create new roles, attach permissions, and edit role details.

To manage roles and permissions from the dashboard, your account must include the truora.roles permission — request it during onboarding or from your Support team if you need it.

For how permissions, roles, and members relate in Truora — including default roles and Master Client Permissions — see Understanding Account Access and Permissions.


📂 Open Members and Roles

  1. Go to Truora Dashboard and sign in.
  2. If you have multiple accounts, select the account you want.
  3. In the sidebar, open Members and Roles.

📋 Roles tab — list roles

Select the Roles tab at the top. Truora lists every role defined for that account.

Roles tab listing all roles for the account

➕ Create a new role

Choose Add role. You can configure:

Field Details
Name How this role is labeled in the dashboard
Copy from existing role Optionally start from another role’s permission set
Description Short note on what this role is for
Role permissions Which capabilities belong to this role (from Master Client Permissions)
Add role form with name, copy from role, description, and permissions

⚙️ View or edit an existing role

Select a role in the list by clicking the name of the role. You can adjust its permissions, name, description, and copy from existing role, as needed.

Remember: Each user has exactly one role assigned. One role can be assigned to many users.


📋 Available Permissions Reference

Below is a reference list of grant-style Truora permission strings (action and product-access permissions). Permissions that serve only as deny masks on specific fields in API outputs are not listed here — your Support team sets those when needed.

Actual permissions vary by contract: only strings present in your Master Client Permissions list can be assigned to roles.

Digital Identity — flows

Permission Description
identity.flows.create Create a flow
identity.flows.read Read flows
identity.flows.update Update flows
identity.flows.delete Delete a flow
identity.flows.avoid_enter_authorization Skip verification enter-authorization constraints

Digital Identity — processes and DI resources

Permission Description
identity.processes.create Create a process
identity.processes.read Read a process
identity.processes.read.own Read identity processes the agent initiated or participated in
identity.processes.delete Delete a process
identity.processes.update Update a process
identity.processes.override.status Override identity process status
identity.processes.send_link Send access links for identity processes
identity.pdf.read Access PDF reads on DI resources
identity.validations.read Read validations on DI resources
identity.variables.read Read variables on DI resources
identity.geolocation.read Read geolocation on DI resources
identity.customers.read Read customer profiles on DI resources

Digital Identity — WhatsApp (flows, outbound, lines)

Permission Description
identity.whatsapp.inbound_flows.create Create an inbound WhatsApp flow
identity.whatsapp.inbound_flows.read Read an inbound WhatsApp flow
identity.whatsapp.inbound_flows.update Update an inbound WhatsApp flow
identity.whatsapp.inbound_flows.delete Delete an inbound WhatsApp flow
identity.whatsapp.outbound.create Create an outbound
identity.whatsapp.outbound.read Read an outbound
identity.whatsapp.outbound.update Update an outbound
identity.whatsapp.outbound.send Send outbound flow
identity.whatsapp.outbound.delete Delete an outbound
identity.whatsapp.waba_lines.create Create a WhatsApp Business line
identity.whatsapp.waba_lines.read Read WhatsApp Business lines
identity.whatsapp.waba_lines.update Update WhatsApp Business lines
identity.whatsapp.waba_lines.delete Delete WhatsApp Business lines

Validations — core APIs and labeling

Permission Description
validations.validation.create Create a validation
validations.validation.read Read a validation
validations.validation.update Update a validation
validations.validation.delete Delete a validation
validations.enrollment.read Read an enrollment
validations.account.read Read a validation account
validations.face_recognition.enrollments.delete Delete face recognition enrollments
validations.face_recognition.enrollments.create.direct Create face recognition enrollments directly
validations.manual_review Perform manual reviews
validations.labeling_analyst Perform labeling tasks as an analyst
validations.labeling_manager Manage labeling projects
validations.authenticate Use authenticate validations

Validations — product and country bundles

Permission Description
validations.face_recognition Face recognition validation product
validations.face_search Face search validation product
validations.enterprise_data Enterprise-data validation product
validations.documents_validation_sv Document validations — El Salvador
validations.documents_validation_ar Document validations — Argentina
validations.documents_validation_co Document validations — Colombia
validations.documents_validation_mx Document validations — Mexico
validations.documents_validation_br Document validations — Brazil
validations.documents_validation_pa Document validations — Panama
validations.documents_validation_cl Document validations — Chile
validations.documents_validation_pe Document validations — Peru
validations.documents_validation_cr Document validations — Costa Rica
validations.documents_validation_ve Document validations — Venezuela
validations.documents_validation_bo Document validations — Bolivia
validations.documents_validation_ec Document validations — Ecuador
validations.documents_validation_do Document validations — Dominican Republic
validations.documents_validation_all Document validations — all configured regions
validations.voice_recognition Voice recognition validation product
validations.cell_phone_validation_co Cell-phone validation — Colombia
validations.cell_phone_validation_mx Cell-phone validation — Mexico
validations.cell_phone_validation_br Cell-phone validation — Brazil
validations.email_validation Email validation product
validations.electronic_signature_validation Electronic-signature validation product
validations.identity_questions Identity-questions validation product

Background checks

Permission Description
checks.country_co Background checks — Colombia
checks.country_cl Background checks — Chile
checks.country_br Background checks — Brazil
checks.country_bo Background checks — Bolivia
checks.country_mx Background checks — Mexico
checks.country_pa Background checks — Panama
checks.country_cr Background checks — Costa Rica
checks.country_ar Background checks — Argentina
checks.country_ec Background checks — Ecuador
checks.country_pe Background checks — Peru
checks.country_all Background checks — all configured regions
checks.country_co_premium Background checks — Colombia premium
checks.behavior Behavior-oriented checks
checks.check.read Read a check
checks.attachments.read Read check attachments
checks.details.read Read check details
checks.pdf.read Read check PDFs
checks.variables.read Read check variables
checks.collectors.credentials.read Read collector credentials
checks.collectors.credentials.upsert Create or update collector credentials
checks.collectors.credentials.delete Delete collector credentials

History reports (API product)

Permission Description
history_reports.read Read history reports
history_reports.create Create history reports

Connect — WhatsApp

Permission Description
connect.whatsapp.flows_list.access Access the WhatsApp flows list
connect.whatsapp.flows.access Access the flows section
connect.whatsapp.flows_detail.access Access the flow-detail section
connect.whatsapp.history_reports.access Access the history-reports section
connect.whatsapp.metrics.access Access WhatsApp metrics
connect.whatsapp.integrations.access Access WhatsApp integrations
connect.whatsapp.settings.access Access WhatsApp settings
connect.whatsapp.agents.access Access WhatsApp agents
connect.whatsapp.agents.conversations.owner.update Change conversation owner
connect.whatsapp.agents.conversations.owner.own.update Change conversations you own
connect.whatsapp.agents.conversations.owner.all.update Change owner for any conversation
connect.whatsapp.agents.conversations.all.read List all conversations
connect.whatsapp.agents.conversations.own.read View your conversations
connect.whatsapp.agents.conversations.unassigned.read View unassigned conversations
connect.whatsapp.agents.conversations.all_closed.read View all closed conversations
connect.whatsapp.agents.conversations.update Update a conversation
connect.whatsapp.agents.conversations.create Create a conversation
connect.whatsapp.agents.conversations.read Read a conversation
connect.whatsapp.agents.conversations.labels.delete Delete a conversation label
connect.whatsapp.agents.conversations.labels.create Create a conversation label
connect.whatsapp.agents.conversations.labels.update Update a conversation label
connect.whatsapp.agents.groups.read View agent groups
connect.whatsapp.agents.groups.update Update or create a group
connect.whatsapp.agents.groups.delete Delete a group
connect.whatsapp.agents.groups.create Create a group
connect.whatsapp.agents.templates.create Create an agent template
connect.whatsapp.agents.templates.read Read agent templates
connect.whatsapp.agents.templates.update Update an agent template
connect.whatsapp.agents.templates.delete Delete agent templates
connect.whatsapp.agents.status.all.update Update any agent status
connect.whatsapp.agents.status.own.update Update your agent status
connect.whatsapp.agent_management.access Access agent management
connect.whatsapp.agent_management.groups_counters.read Read agent group counters
connect.whatsapp.contacts.exports.create Export contacts to CSV
connect.whatsapp.contacts.exports.read List and download contact exports
connect.whatsapp.campaigns.create Create WhatsApp campaigns
connect.whatsapp.waba_line.manage Manage WhatsApp Business lines

Connect — engagement

Permission Description
connect.engagement.agent.capacity.read View agent capacity settings
connect.engagement.agent.capacity.manage Manage agent capacity settings
connect.engagement.chat.exports.read View engagement chat export requests
connect.engagement.chat.exports.manage Manage engagement chat exports
connect.engagement.catalogs.read Read catalogs and catalog products
connect.engagement.catalogs.catalog_manage Create, update, delete, and publish catalogs
connect.engagement.catalogs.product_manage Manage catalog products
connect.engagement.catalogs.link Link catalogs to a WhatsApp Business Account

Account Management

Permission Description
account.users.list List account users
accounts.bre.create Create BRE rules
accounts.hook.create Create webhook hooks
accounts.integration.create Create account integrations
accounts.config.update Update account settings
accounts.media.read Read hosted account media
integrations.credentials.read_all View all integration credentials
truora.users Manage Truora dashboard users
truora.keys Manage API keys
truora.roles Manage dashboard roles

Client Media

Permission Description
client_media.request_upload Request secure media uploads
client_media.read Read client media assets
client_media.read.override_status Read media tied to overridden process status

Forms

Permission Description
forms.read Read a form
forms.create Create a form
forms.update Update a form
forms.delete Delete a form
forms.utility_lists.create Create a utility list
forms.utility_lists.update Update a utility list
forms.responses.read Read a form response
forms.responses.create Create a form response

Other permissions

Permission Description
products.all Access all Truora products (excluding user, keys, and roles administration)
audit_logs.read Read audit logs
consents.read Read consent records