# Adding accounts

{% hint style="info" %}
Albys extension APIs are provided via the `window.alby` object (very much like [WebLN](https://www.webln.guide)). You don't need to add any dependencies or packages to your project.
{% endhint %}

### API

```javascript
async function addAccount(request: AddAccountRequest) : AddAccountResponse;

interface AddAccountRequest = {
    name: string;
    connector: string;
    config: object;
}

interface AddAccountResponse = {
    success: boolean;
    error: string?;
}
```

#### Name

The display name for the account you want to add to Alby. (this can be changed by users later on, but make sure to provide some recognizable name)

#### Connector

The parameters vary depending on the type of account you want to add. The following types are available:

* `citadel` \*
* `commando` (Core Lightning)
* `eclair`
* `galoy`
* `kollider`
* `lnbits` \*
* `lnc` (Lightning Node Connect)
* `lnd` \*
* `lndhub` \*

{% hint style="info" %}
\* Prefix the type with `native` if you want to connect via TOR (e.g. `nativelnd`)
{% endhint %}

#### Config

The config contains credentials to connect to the users wallet, they differ by the connector  you are trying to connect. Take a look into our repository, choose the connector you are about to add and look for the config object:

<https://github.com/getAlby/lightning-browser-extension/tree/master/src/app/screens/connectors>

This should give you an idea of what parameters need to be provided. Feel free to reach out to us at <mark style="color:blue;"><support@getalby.com></mark> in case of any questions, we're happy to help!

### Code Example

```javascript
await window.alby.enable();
const result = await window.alby.addAccount({
  name: "⚡️ LNbits (legend.lnbits.com)", 
  connector: "lnbits", 
  config: {
    "adminkey": "...",
    "url": "https://legend.lnbits.com"
  }
});
```

### Screenshots

![](https://3903835479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5v1D1WJg7nITCqn5NLQJ%2Fuploads%2FnXl9GVaiOv719HOsVc7y%2Fimage.png?alt=media\&token=3dd9be9d-9f0b-41f2-8b61-55a4bafc31cd)<img src="https://3903835479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5v1D1WJg7nITCqn5NLQJ%2Fuploads%2FirijoJrAWtjYzqcoff4t%2Fimage.png?alt=media&#x26;token=d4c3333e-d37f-41f7-807e-d49f5947df5c" alt="Screenshot of the new account that just has been added to the extension" data-size="original">

### Demo

{% embed url="<https://codepen.io/getalby/pen/bGmOjVB>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.getalby.com/developer-guide/developer-guide/alby-browser-extension-apis/window.alby/adding-accounts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.