Skip to content

Structure

Open API Keys from the left sidebar to manage your keys.

Page

URL

Purpose

Key list

/keys/list

View all keys for your team

Create key

/keys/new

Set up a new key

Key details

/keys/:id

Edit permissions, regenerate, or delete

Key list

api-keys-list

The list shows each key's name, creation date, and how many integrations (apps) are configured.

From here you can:

  • Create New API Key — start the setup wizard

  • Edit — change name, apps, components, or connections

  • Regenerate Key — issue a new secret (the previous one stops working)

The secret value is never shown on this page — only when a key is first created or regenerated.

Create a key

api-key-create

What you configure

Field

Required

Description

Key name

Yes

A label for your reference

Integrations

Yes (at least one app)

Apps this key may access

Components

Yes, per app

Specific actions/triggers the key may run

Connection

When the app requires sign-in

Which connected account Monkedo should use

Example of what gets saved:

{
  "name": "Production API Key",
  "connections": [
    {
      "appKey": "gmail",
      "connectionId": "507f1f77bcf86cd799439011",
      "allowedComponents": ["action.gmail.send-email"]
    }
  ]
}

Setup flow

  1. Enter a Key Name.

  2. Under Integrations, search for and select an app.

  3. A Configure window opens — choose components and, if needed, a connection.

  4. Repeat for any additional apps.

  5. Click Create API Key once every app shows as configured.

  6. Copy the key immediately — you won't be able to view it again after closing the dialog.

Key Details (edit)

api-key-details

The edit page lets you change integrations the same way as during creation. You can also:

Action

What happens

Regenerate

A new secret is issued; the old one stops working right away

Configure / Remove app

Changes are saved when you update an app's settings

Delete API Key

The key is removed permanently and stops working immediately

Removing an app from a key also removes any triggers that were registered for that app under this key.

Configure App (modal)

api-key-configure

Each app opens a configuration dialog with two parts.

Components

Choose which actions and triggers this key may use for the app.

  • Check individual components, or use Select All.

  • Only selected components are callable through the API.

Connection

Shown when the app requires authentication (OAuth, API key, credentials, etc.).

  1. Select the components you need first.

  2. Click Get Connections to see accounts that support those components.

  3. Pick an existing connection or click Connect {App} to link a new account.

Monkedo flags connections that are expired or missing permissions, so you can pick a working account before saving.

Save is enabled when:

  • At least one component is selected, and

  • A connection is selected if the app requires one