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

# Registering users and assets

> Connecting assets to markets

Participation starts with registering your users with Axle, and associating them with assets.

To participate in a market, we'll typically need:

* the user's **addresss**, from which we can retrieve the meter identifier
* the user's **tariff**, to understand how they pay for energy
* a way to retrieve telemetry from, and send commands to, the asset

## Registering users

**Using a hosted flow**

We'll setup a [hosted flow](https://docs.axle.energy/components/getting-started/hosted-app.md) for you to send via email or in-app notifications.

If you'd like to check a user's eligibility
for flex before surfacing the flow, you can use the [eligibility endpoint](https://docs.axle.energy/api-reference/meter/get-by-address.md).

**Components**

**1. Collect user address**

Use the [Address component](https://docs.axle.energy/components/components/address.md) to collect the user's address.

**2. Collect user tariff**

Use the [Tariff component](https://docs.axle.energy/components/components/tariff.md) to collect the user's tariff.

> [!TIP]
>
> When you use our components, information is submitted to our server directly. When you first create a new user, we'll return the ID we're using to identify them.

**Via our API**

\[!NOTE] To create a site, you'll need the MPAN. If you don't know the MPAN for a site, you can retrieve it from the user's address
using [this endpoint](../api-reference/meter) and the workflow detailed [here](https://docs.axle.energy/workflows/find-mpan.md).
Create a site using the [Create Site](https://docs.axle.energy/api-reference/entities/site/post.md) endpoint. This will create a user in our system, and return a unique identifier for the user. You can pass the tariff information when creating a site.

If you want to enable [payments](https://docs.axle.energy/workflows/payments/overview.md) for your users, include their `email` when registering them. A user email is required to process payments through our provider, Stripe. We also send payment-failure notifications and, if enabled, two-factor authentication codes to this address.

## Adding assets

Once you've created a user in our system, we need to associate it with one or more assets.

**Via our API**

**1. Retrieve the site ID**

When you register a user, we create a site for them. This is a unique identifier for the user, and is used to identify the asset.

**2. Register the asset**

Register an asset to that site using the [Create Asset](https://docs.axle.energy/api-reference/entities/asset/post.md) endpoint.

**Via your API**

If you have an [OAuth flow](https://auth0.com/docs/authenticate/protocols/oauth), we'll integrate into that to receive delegated access to the asset.

Alternatively, if you have an API with a centralized authorization system, we can submit details of registered assets
to an endpoint of your choice.

## Managing assets

You can view, update, and delete assets and sites via the [API](../api-reference/entities/asset/).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.