Skip to main content

Connections

Many workflow blocks reach out to other services — Slack, Gmail, Google Sheets, an AI provider, and so on. Connections is where you set up the accounts and API keys those blocks use. Secrets are stored securely and only used when a workflow runs — they're never shown back to you.

The Connections Tab​

Open Workflows → Connections. Connections are grouped into two shelves:

  • Connected accounts — services you sign into (OAuth), like Google and Microsoft
  • API credentials — services you connect with a key or token, like OpenAI, Slack, or Notion

Connections tab

Connecting an Account (Sign-in)​

  1. Click Connect account
  2. Choose the provider — Google or Microsoft
  3. Sign in through the popup and approve access

When it succeeds you'll see Account connected.

:::info Coming soon More sign-in providers (such as Slack and GitHub) are on the way — they appear with a Soon badge for now. :::

Adding an API Key​

  1. Click Add connection
  2. Search for the service (e.g. Slack, Notion, OpenAI)
  3. Give the connection a Name (e.g. "My OpenAI key")
  4. Paste the key or token
  5. Click Create

For services that support it, Arketic runs a quick test and tells you the result — for example Credential verified.

Health & Testing​

Each connection shows a health state:

StateMeaning
ConnectedWorking
InvalidThe key or token was rejected — re-enter it
Action neededExpired — reconnect to refresh
Not testedHasn't been checked yet
Can't auto-verifyThis service can't be tested automatically

Use Test now to re-check a key connection, or Reconnect to refresh an account.

Using a Connection in a Block​

When you configure a block that needs a service, pick the connection from its credential dropdown. If you don't have one yet, you can add it right there. For sign-in–based services, connect the account first under Connections.

Managing a Connection​

Click a connection to open its details:

  • See its type, when it was added, and when it was last checked
  • Re-enter a key or Reconnect an account when needed
  • Delete or Disconnect it (blocks that used it will stop working)

Tips​

  • Name connections clearly — you may have more than one per service
  • Watch for Action needed — reconnect before a run depends on it
  • Least access — give keys only the permissions the workflow needs