> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Genesys Cloud permissions for OpenCX

> The Genesys Cloud role permissions OpenCX needs, the optional ones each feature adds, and what the admin who signs in must hold. Check before you connect.

This page lists every Genesys Cloud permission the role OpenCX uses can hold. Read it before you [connect](https://docs.open.cx/integrations/genesys/connect.md), when a feature stays off, or when **Health** asks you to add a permission. Signing in creates the role for you and grants it in the divisions you choose. If you create it yourself, grant it in the divisions OpenCX should work in.

> [!NOTE]
>
> The role reads and writes only in the divisions it's granted in, so OpenCX can't see agents, queues or flows outside them. Its message flow goes in a chosen division: Home if you chose it, otherwise the first by name. Genesys doesn't divide messaging connections, the Assist panel or presence definitions, so those are org-wide, and contacts with no division stay visible.
>
> It can't change queues. Without `routing:queue:add` it can't create them either. Creating an email route or adding queue members always needs a Genesys login with routing write access.

## Required

| Area | Permissions |
| - | - |
| Messaging | `messaging:integration:add`, `messaging:integration:view`, `messaging:integration:edit`, `messaging:integration:delete`, `routing:message:manage`, `routing:conversation:edit`, `conversation:message:create`, `conversation:message:receive`, `conversation:communication:view`, `conversation:communication:disconnect`, `conversation:communication:blindTransfer`, `conversation:participant:wrapup`, `conversation:participant:attributesview`, `conversation:threadingTimeline:view`, `conversation:threadingTimeline:edit` |
| Directory | `directory:user:view`, `routing:queue:view`, `routing:skill:view`, `routing:wrapupCode:view`, `groups:team:view`, `presence:presenceDefinition:view`, `presence:userPresence:edit` |
| Analytics | `analytics:conversationDetail:view`, `analytics:queueObservation:view` |
| External contacts | `externalContacts:contact:add`, `externalContacts:contact:view`, `externalContacts:contact:edit`, `externalContacts:contact:enrich`, `externalContacts:identity:merge`, `externalContacts:externalSource:add`, `externalContacts:externalOrganization:add`, `externalContacts:externalOrganization:view`, `externalContacts:externalOrganization:edit`, `externalContacts:externalOrganization:enrich` |
| Flow and panel | `integrations:integration:add`, `integrations:integration:view`, `integrations:integration:edit`, `integrations:integration:delete`, `architect:flow:view`, `architect:flow:add`, `architect:flow:edit`, `architect:flow:delete`, `architect:flow:publish`, `architect:flow:unlock`, `architect:job:create`, `architect:job:view`, `architect:ui:view`, `oauth:client:view` |

## Optional, added when the admin holds them

These depend on your Genesys licence and never block connecting. Signing in adds the ones the admin holds. Without them, connecting works and only that feature stays off.

| Feature | Permissions |
| - | - |
| [Workitems](https://docs.open.cx/integrations/genesys/workitems.md) | `workitems:workitem:add`, `workitems:workitem:view`, `workitems:workitem:edit`, `workitems:worktype:view`, `workitems:status:view`, `workitems:workitemSchema:view` |
| Call recordings, and messaging in **Past conversations** imports | `recording:recording:view` |
| Genesys transcription for live assist | `conversation:transcription:view` |
| Knowledge import | `knowledge:knowledgebase:view`, `knowledge:document:view` |
| [Native email](https://docs.open.cx/integrations/genesys/native-email.md) | `conversation:agentlessEmail:send`, `routing:queue:add` |
| [Native messaging](https://docs.open.cx/integrations/genesys/native-messaging.md), and flow messages shown as the flow's on handed-off messaging sessions | `integration:botconnector:send`, `conversation:message:view` |
| WhatsApp templates sent from the inbox, and [canned responses as macros](https://docs.open.cx/integrations/genesys/macros.md) | `responses:response:view` |
| Diagnostics | `architect:flowInstance:search`, `audits:audit:view`, `usage:events:view` |
| Typed custom fields on contacts and companies | `externalContacts:customFields:view` |
| [Conversation custom attributes](https://docs.open.cx/integrations/genesys/contacts.md#conversation-custom-attributes) (Genesys Cloud CX 2 or higher) | `conversation:customAttributes:view`, `conversation:customAttributes:edit` |
| Moving the Genesys conversation when a session's team or assignee changes | `conversation:communication:transfer` |
| [Assist panel](https://docs.open.cx/integrations/genesys/assist-panel.md) shown to the **OpenCX Assist** group OpenCX keeps | `directory:group:add`, `directory:group:edit`, `directory:group:delete` |
| [Business hours from a Genesys schedule group](https://docs.open.cx/integrations/genesys/handoff.md#business-hours) | `routing:scheduleGroup:view`, `routing:schedule:view`, `routing:emergencyGroup:view` |
| [Quality evaluation scores](https://docs.open.cx/integrations/genesys/insights.md#quality-evaluations) on the session (quality management) | `quality:evaluation:view` |
| [Data Actions and data tables](https://docs.open.cx/integrations/genesys/workflow-actions.md#data-actions-and-data-tables) in workflows | `integrations:action:view`, `integrations:action:execute`, `architect:datatable:view` |
| [Callbacks](https://docs.open.cx/integrations/genesys/workflow-actions.md#callbacks) booked by a workflow or the AI | `conversation:callback:create` |
| [Drafts in Agent Copilot](https://docs.open.cx/integrations/genesys/assist-panel.md#drafts-in-agent-copilot) (Agent Copilot) | `conversation:suggestion:view`, `conversation:suggestion:edit` |
| [Typing indicators](https://docs.open.cx/integrations/genesys/channels.md#typing-indicators) | `messaging:setting:view`, `messaging:setting:add`, `messaging:setting:edit`, `messaging:setting:delete` |
| [Erasure in both directions](https://docs.open.cx/integrations/genesys/erasure.md#erasure-in-both-directions): deletion requests filed for deleted contacts, and completed ones applied in OpenCX | `gdpr:request:view`, `gdpr:request:add` |

Calls and callbacks in **Show every Genesys conversation**, and notes on external contacts in both directions, need nothing beyond the permissions above.

## Optional, added by you

Add these to the role yourself if you want them. Signing in doesn't add them.

| Feature | Permissions |
| - | - |
| [Genesys summaries](https://docs.open.cx/integrations/genesys/insights.md) | `conversation:summary:view` |
| [Sentiment and categories](https://docs.open.cx/integrations/genesys/insights.md), filling gaps in call transcripts, and the transcript of [calls you see without streaming](https://docs.open.cx/integrations/genesys/every-conversation.md#calls-and-callbacks) | `speechAndTextAnalytics:data:view`, `recording:recording:view` |

## For the admin who signs in

To sign in, the admin also needs `authorization:role:view`, `authorization:role:add`, `authorization:role:edit`, `authorization:division:view`, `authorization:grant:add` and `oauth:client:add`. Changing divisions on a later sign-in also needs `oauth:client:edit`. If your org enforces OAuth scopes, the first sign-in also needs `oauth:client:authorize`, to approve OpenCX under **Authorized Applications**.

## Related

> [card] [Connect Genesys Cloud](https://docs.open.cx/integrations/genesys/connect.md)
>
> Sign in or use a client ID and secret.

> [card] [Fix connecting and setup](https://docs.open.cx/integrations/genesys/troubleshooting-setup.md)
>
> Missing permissions, divisions and sign-in errors.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.