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

# Quickstart

> Make your first ego API request in under five minutes.

By the end of this page you'll call the ego API and list the connections your key can read.

<Warning>
  The ego API is in preview. These endpoints aren't live yet, so the request below
  won't return real data. The flow is the one we're building toward — follow it to
  see the shape of a call and its response.
</Warning>

<Steps>
  <Step title="Get an API key">
    Create a key in the ego dashboard and copy it. Treat it like a password.
  </Step>

  <Step title="Set it in your shell">
    Export the key so the request can read it:

    ```bash theme={null}
    export EGO_API_KEY="sk_test_your_key_here"
    ```
  </Step>

  <Step title="List your integrations">
    Call the API with your key as a bearer token:

    ```bash theme={null}
    curl https://api.myego.dev/api/integrations \
      -H "Authorization: Bearer $EGO_API_KEY"
    ```
  </Step>

  <Step title="Read the response">
    A successful call returns the integrations the key can see. Token material never
    appears — only the provider, the account, and the buckets you granted:

    ```json theme={null}
    {
      "data": [
        {
          "id": "conn_4f2a9c",
          "provider": "google",
          "email": "ada@example.com",
          "buckets": ["email"],
          "status": "active"
        }
      ]
    }
    ```
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Grant scoped access" icon="key" href="/guides/granting-access">
    Connect a source and hand an agent one scope.
  </Card>

  <Card title="Request approvals" icon="circle-check" href="/guides/approvals">
    Have an app ask the owner to decide.
  </Card>

  <Card title="Push notifications" icon="bell" href="/guides/notifications">
    Send the owner an event from an app.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/introduction">
    Every endpoint, parameter, and response.
  </Card>
</CardGroup>