Administer

Manage Connections

Add and test the connections used by workflows and cases.

Before you start

Confirm the system address, Connection type, sign in method, and network rules with the system owner.

Keep the password, token, or key in an approved secret store until you enter it in Pūnaha.

Open Connections

A Connection stores settings for email, an API, or a database. A workflow can use the Connection without storing its password.

The Connections page with the Add Connection button
The page shows which Connections are ready and which ones need attention. Earlier development interface, captured 22 August 2026. Follow the current text for RC1. Open the full image.

Add a Connection

  1. Choose Add Connection.
  2. Enter a clear name and purpose.
  3. Choose the type.
  4. Enter the server address.
  5. Choose the sign in method.
  6. Enter the login details.
  7. Check the secure connection and allowed host settings.
  8. Save the Connection.

Test the Connection

  1. Choose Test on the saved Connection.
  2. Wait for the result.
  3. Read the complete message.
  4. If the test succeeds, check the time and test message saved on the card.
  5. Give access only to the people and services that need it.

A successful test proves that the saved Connection worked at that time. It does not prove that every action is allowed.

Check the result in a solution

Use safe sample information in a draft workflow. Check the result before you publish the workflow.

Protect passwords and keys

Do not put passwords in a workflow, page address, screenshot, or normal log.

A successful test only proves that the Connection worked at that time. It does not prove that every action is allowed.

If the test fails

  1. Read the saved test message.
  2. Check the server address and port.
  3. Check the sign in method and secret.
  4. Check the secure connection setting.
  5. Check the allowed host and private network rules.
  6. Test again only after you change the likely cause.

Change a Connection

Check which published workflows use it. If a password is exposed, disable access and change the password at its source. Then update and test the Connection.

Next step

Use the Connection in a draft workflow journey. Keep it out of the published workflow until the test succeeds.

Pūnaha Docs

Search the guides

Enter at least two characters.

    Product screen

    View the full screenshot