Manage connections

Use the Connections page to set up and manage connections Credentials and other settings that enables workflows to communicate with external systems, services, or applications. It's required to pass data between the workflow and the indicated service, which could be a cloud service, business application, or content store. for passing data between workflows on your tenancy and connectors A software component that allows seamless integration with third-party services, business applications, and content stores. Examples include Salesforce, Box, and Microsoft SharePoint. Connectors are used to create connections required for workflow actions and start events.. You can add, edit, and delete connections, as well as identify invalid connections. You can also Assign User and Owner permissions to connections.

Jump to: 

Important: 

  • You can create up to 1000 connections per tenant.

  • If your workflow is configured to start when an item is updated and also includes an action that updates the same item, we recommend using different connections with separate accounts for the start event and action. For more information, see Best practices when designing workflows.

View the Connections page

  1. On the top navigation bar, click Automate.

  2. On the left, click Connections.

Add a connection

  1. Obtain credentials and other requirements.

    Browser-stored credentials are accessed for new connections. Either clear credentials from memory or make sure the stored credentials are for the correct environment. For example, if you intend to create a connection to a Salesforce sandbox environment, then make sure the browser-stored Salesforce credentials are for the sandbox environment rather than another Salesforce environment.

    For other items required for your connection, see Connectors.

  2. On the Connections page, click Add connection.

  3. In the Add connection panel:
    1. Select a Connector service, such as Salesforce.
    2. Click Next.
    3. In Connection settings, enter a Connection name.

      4. Note: The name must not include any of the following characters: < > " ' ` \ / { } [ ] % $ # * ^ ! @ ~ ? = , ;

      To make it easier to identify connectors created, we recommend using a name that is easily identifiable. You can use a naming convention such as the one given below:

      Environment Name-EnvironmentURL-Username

      For example, SFDC Sandbox-https://<environment>.com-username@domain.com

    1. Complete other fields as required. See Connectors.

    2. Click Connect.

    The entered name is validated for uniqueness. You are prompted for login credentials to the selected connector service. The URL for the connector service, including domain, is indicated above the credential fields.

  4. Enter login credentials for the connector service.

    Upon successful login, you are prompted to grant or deny access to Nintex Automation Cloud.

  5. Grant access to Nintex Automation Cloud.

    The connection is now ready to use in workflow start events and actions during workflow design.

  1. Access the Designer page: 

    • On the top navigation bar, click Automate > Workflows, and then select the required workflow.

      • (Or)

    • On the top navigation bar, click Automate > Create workflow.
  2. Click the connector action or select the start event you want to add the connection to, or drag an action into the workflow and select it.

  3. In the drop-down list for Connection, select Add connection.

  4. In Connection settings, enter a Connection name.

      Note: The name must not include any of the following characters: < > " ' ` \ / { } [ ] % $ # * ^ ! @ ~ ? = , ;

      To make it easier to identify connectors created, we recommend using a name that is easily identifiable. You can use a naming convention such as the one given below:

      Environment Name-EnvironmentURL-Username

      For example, SFDC Sandbox-https://<environment>.com-username@domain.com

  5. Complete other fields as required. See Connectors.

  6. Click Connect.

    The entered name is validated for uniqueness. You are prompted for login credentials to the selected connector service. The URL for the connector service, including domain, is indicated above the credential fields.

  7. Enter login credentials for the Connector service.

    Upon successful login, you are prompted to grant or deny access to Nintex Automation Cloud.

  8. Grant access to Nintex Automation Cloud.

    The connection is now ready to use in workflow start events and actions during workflow design.

Edit, delete, and assign permissions to connections

On the Connections page, to the right of the connection:

  1. Click .
  2. Select Edit from the options menu.
  3. Edit the Connection name, if needed.
  4. Edit other fields as needed. See Connectors.
  5. Click Connect.
  6. Complete the authentication process.

On the Connections page, to the right of the connection:

  1. Click .

  2. Select Delete from the options menu.

There are two types of connection permissions: Owners and Users.

Permissions for Owners include the following:

  • Assign Owner/ User permissions to other tenant members.
  • Use, edit, or delete connections.

Permissions and restrictions for Users include the following:

  • Use existing connections in the Designer page.
  • Users cannot assign connection permissions to other tenant members.
  • Users cannot edit and delete connections.
Note: 
  • The tenant member who creates a connection has Owners permissions by default.

  • Administrators have Owners permissions to connections in the tenant.

Follow these steps to assign connection permissions from the Connections page:

  1. On the Connections page, click to the right of the name of the connection to which you want to assign permissions.
  2. Select Permissions from the options menu.
  3. In the window that appears:
    • To assign all tenant members the Owners or Users connection permissions:
      1. Click in the Owners or Users field.
      2. Click Everyone.
      3. Click Save permissions.
    • To assign a group of users the Owners or Users connection permissions:
      1. Click in the Owners or Users field.
      2. Select the Group you want to assign permission to from the GROUPS list.
        • Hover over the name of the group and click Show members to see the list of members in the group.
      3. Click Save permissions.

      For information about adding and editing groups, see Create, edit, and manage user groups.

    • To assign individual tenant members the Owners or Users connection permissions:
      1. Type the name in the Owners or Users fields.
      2. Select the users to whom you want to assign permissions.
      3. Click Save permissions.

Identify invalid connections

  1. On the Connections page, under the Name column, look for any instances of the invalid indicator ().
  2. Click .
  3. Select Edit from the options menu.
  4. Update the configurations as required.

Column or selection Description

Add connection

Displays the Add connection panel with fields for connector and connection. Additional fields are displayed for some connectors.

Note: You can also add connections while designing your workflow. For designer steps to add connections, see Connectors.

Connection name

Connection name specified when the connection was added. Example: MySalesforceEnvironment.

Note: If the connection has become invalid due to expired credentials or some other reason, then the invalid indicator () appears to the left of the connection name.

Connector

Connector specified when the connection was added. Example: Salesforce.

Date created

Date and time when the connection was added.

Options ()

Lists the following options for the indicated connection.

  • Edit: Allows you to re-authenticate and rename the connection.
  • Permissions: Allows you to assign permissions for connections.
    • Owners: Owners can assign connection permissions, and use, edit, or delete connections. Note that users with the Administrator role also have the same connection permissions.
    • Users: Users can use connections in the Designer page. Users cannot assign connection permissions, edit, or delete connections.
  • Delete: Removes the connection from the tenancy.

Troubleshooting

If you receive a publish error that states that you do not have permissions for connections used in the workflow or that connections used in the workflow have been deleted, attempt to resolve the error with these troubleshooting tips: