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

# Integrations

> Integrations connect Feather to external systems so agents can use authenticated, reusable business capabilities.

Integrations are managed connections to external services. They are the configuration layer that powers integration-backed tools and connected workflows.

## Integrations vs Tools

* **Integrations** store the connection to a service
* **Tools** are the actions an agent performs using that connection

For example, an integration might connect Feather to a scheduling platform, while the tool created from that integration checks availability or books time.

## Typical Uses

* CRM lookups and updates
* Scheduling and appointment systems
* Domain-specific systems of record
* Secure access to third-party APIs across multiple agents

## List Available Integrations

```bash theme={"system"}
curl "https://prod.featherhq.com/api/v1/integrations" \
  -H "X-API-Key: $FEATHER_API_KEY"
```

## Integration Instances

An integration instance is your organization's configured connection for one service. You can have multiple instances when teams, environments, or business units need different credentials or behavior.

Common pattern:

1. Inspect the available integrations
2. Create an instance with the right credentials or settings
3. Enable or reference the resulting capability through tools or agent configuration

## Design Guidance

* Use integrations when the same external system should support multiple agents.
* Use a custom tool when the action is unique to your own backend and does not need a reusable connection model.
* Keep external side effects in integrations or tools, not inside prompts.

## Adjacent Features

Some connected capabilities live in dedicated APIs rather than the generic integrations API, including:

* [Calendar connections](/api-reference/calendar-connections/get-oauth-url-for-external-calendar)
* [Email domains](/api-reference/email-domains/create-an-email-domain)

## Related API Reference

<CardGroup cols={2}>
  <Card title="Available Integrations API" icon="code" href="/api-reference/integrations/list-all-available-integrations">
    See the catalog of supported integration types.
  </Card>

  <Card title="Integration Instances API" icon="code" href="/api-reference/integrations/create-an-integration-instance">
    Create and manage organization-specific integration instances.
  </Card>

  <Card title="Tools" icon="wrench" href="/documentation/core-concepts/tools">
    Expose connected capabilities to agents through tools.
  </Card>

  <Card title="Calendars" icon="calendar" href="/documentation/core-concepts/calendars">
    Use calendar-specific connections and booking flows.
  </Card>
</CardGroup>