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

# Core Concepts

> How connectors, profiles, linked accounts, actions, and events fit together, and what happens when your agent calls one.

<img src="https://mintcdn.com/stackone-60/eqCjS7m4FAN_3XTx/images/concepts-relationships.svg?fit=max&auto=format&n=eqCjS7m4FAN_3XTx&q=85&s=280b8c92b9fae5df17fe75bf886c5cc7" alt="Your Organization contains Projects. Inside a Project, Connector Profiles hold the configuration for a Connector such as Salesforce, Slack, or Workday, and your end-users' Linked Accounts are authenticated against those profiles." style={{ width: "100%", maxWidth: "336px", margin: "1.5rem auto", display: "block" }} width="420" height="524" data-path="images/concepts-relationships.svg" />

A connector is ready to use once these are in place:

1. Set up your [organization and projects](/gateway/concepts/organizations-and-projects).
2. Pick the [connector](/gateway/concepts/connectors) you want and add a [connector profile](/gateway/concepts/connector-profiles) for it.
3. Enable the [actions](/gateway/concepts/actions) and [events](/gateway/concepts/events) you need.
4. [Link an account](/gateway/concepts/linked-accounts) against that profile.
5. [Connect your agent](/connect/overview), or [call actions](/embed/call-actions/rpc-http) directly.

Follow the [Quickstart](/gateway/quickstart) guide to run your first action.

## How a request flows

When your agent calls an action, the request is scoped to one linked account. StackOne authenticates with the provider, transforms the request to the provider's API format, then normalizes the response for the protocol or SDK you're using.

```mermaid theme={null}
sequenceDiagram
    participant App as App / Agent
    participant S as StackOne
    participant P as Provider

    Note over App: Organization → Project<br/>(API key scopes the project)

    rect rgb(236, 253, 245)
        Note over App,P: Actions — your agent calls out
        App->>S: Call action for a Linked Account
        Note over S: Connector Profile —<br/>connector authentication + enabled actions
        S->>P: Authenticated, transformed request
        P-->>S: Raw provider response
        S-->>App: Normalized response
    end

    rect rgb(219, 234, 254)
        Note over App,P: Events — the provider tells you
        P->>S: Provider webhook
        S->>App: Normalized event to your webhook
    end
```

StackOne handles OAuth token refresh, rate limiting, retries, schema normalization, error handling, and audit logging along the way. [Events](/gateway/concepts/events) flow the other way — when something changes in a provider, StackOne normalizes it and delivers it to your webhook.