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

# Layest Integrations: Connect Your Tools and Services

> Connect Layest to your existing tools and services. Browse available integrations, authenticate with OAuth or API keys, and attach them to your agents.

Integrations are the bridges between your Layest agents and the tools your team already uses every day. By connecting a service—whether that's a CRM, a communication platform, or a database—you give your agents real-time access to external data and the ability to take action on your behalf. Without integrations, an agent can only reason with the information you hand it directly; with them, it can read a support ticket, update a contact record, or post a message the moment it decides to act.

## Browse the integrations catalog

The integrations catalog lists every service Layest supports out of the box. To open it:

<Steps>
  <Step title="Open the Integrations page">
    In the left sidebar, click **Integrations**. The catalog loads with all available connectors organized by category.
  </Step>

  <Step title="Search or filter">
    Use the search bar to find a specific service, or click a category chip—**CRM**, **Communication**, **Databases**, **Productivity**, or **Custom Webhooks**—to narrow the list.
  </Step>

  <Step title="Preview a connector">
    Click any connector card to see its description, required permissions, and supported actions before connecting.
  </Step>
</Steps>

## Connect an integration

Layest supports two authentication methods depending on what the service requires: OAuth 2.0 for services that manage their own login flows, and API keys for services that issue static credentials.

### OAuth flow

<Steps>
  <Step title="Click Connect">
    On the connector's detail page, click **Connect**. Layest redirects you to the service's authorization screen.
  </Step>

  <Step title="Authorize access">
    Log in with your credentials for that service and approve the requested permissions. You are redirected back to Layest automatically.
  </Step>

  <Step title="Name the connection">
    Give the connection a recognizable name (for example, `Support Zendesk – Prod`) and click **Save**. The connection appears as active in your integrations list.
  </Step>
</Steps>

### API key

<Steps>
  <Step title="Generate a key in the external service">
    Follow the service's documentation to create an API key or access token with the permissions your agent will need.
  </Step>

  <Step title="Paste the key into Layest">
    On the connector's detail page, select **API Key**, paste the key into the credential field, and click **Verify**. Layest confirms the key is valid before saving.
  </Step>

  <Step title="Save the connection">
    Name the connection and click **Save**. Layest encrypts the key at rest and never exposes it in plain text after this point.
  </Step>
</Steps>

<Note>
  Layest requests only the permission scopes each connector explicitly needs. Review the listed scopes on the connector detail page before authorizing. You can always revoke access without deleting the integration record.
</Note>

## Attach an integration to an agent

Connecting a service to Layest makes it available workspace-wide, but you still need to attach it to individual agents before those agents can use it.

<Steps>
  <Step title="Open the agent editor">
    Navigate to **Agents**, select the agent you want to configure, and click the **Integrations** tab inside the editor.
  </Step>

  <Step title="Add an integration">
    Click **+ Add Integration**, choose the active connection from the dropdown, and select which actions the agent is allowed to perform (for example, *Read tickets*, *Create comments*).
  </Step>

  <Step title="Save the agent">
    Click **Save**. The agent can now call that integration during its runs.
  </Step>
</Steps>

## Manage and revoke integrations

Visit **Integrations → Active Connections** at any time to review every connected service. From this view you can:

* **Rename** a connection to keep your list organized as your stack grows.
* **Re-authorize** a connection whose OAuth token has expired or whose API key has been rotated.
* **Revoke** a connection entirely—this immediately prevents any agent from using it, and Layest deletes the stored credentials.

Revoking a connection does not delete the agents that reference it, but those agents will surface an error if they attempt to call the disconnected service. Update the affected agents to use a replacement connection or remove the integration reference.

## Integration categories

Browse connectors across the following categories in the catalog:

<CardGroup cols={2}>
  <Card title="CRM" icon="address-book">
    **Salesforce** – Read and update leads, contacts, and opportunities.

    **HubSpot** – Sync contacts, deals, and marketing lists.

    **Pipedrive** – Query and create deals and activity notes.
  </Card>

  <Card title="Communication" icon="message">
    **Slack** – Post messages, read channels, and react to events.

    **Gmail** – Send emails, read threads, and manage labels.

    **Microsoft Teams** – Post to channels and read meeting summaries.
  </Card>

  <Card title="Databases" icon="database">
    **PostgreSQL** – Run parameterized queries and return results.

    **MySQL** – Read and write rows with scoped table access.

    **Airtable** – List, create, and update records in any base.
  </Card>

  <Card title="Productivity" icon="briefcase">
    **Notion** – Read and create pages and database entries.

    **Google Sheets** – Read ranges and append rows.

    **Jira** – Create issues, update status, and add comments.
  </Card>

  <Card title="Custom Webhooks" icon="webhook">
    **Outbound Webhook** – POST a JSON payload to any URL your agent triggers.

    **Inbound Webhook** – Receive an HTTP POST to start an agent workflow.
  </Card>

  <Card title="More coming soon" icon="circle-plus">
    The catalog grows regularly. Vote for connectors you need on the [Layest roadmap](https://layest.ai/roadmap) or reach out to your account team to discuss a custom connector.
  </Card>
</CardGroup>