# Load template

`POST https://api.cryptohopper.com/v1/template/{template_id}/load/{hopper_id}`

Part of [Templates](https://www.cryptohopper.com/api-documentation/api-reference/templates.md) in the Cryptohopper API reference.

Loads one of the user's own templates into one of the user's bots. The bot's config, config pools, triggers and signal subscriptions are replaced by those of the template; the bot keeps its exchange, base currency, API keys and paper trading setting.

OAuth scope: `read`, `manage`

An AI Bot template only loads into an AI Bot and a grid template only into a Grid Bot. When a paid signal of the template has no active subscription, the message asks the user to pay for it. When the template uses a strategy the user no longer has, the bot gets no strategy.

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |

## Path parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `hopper_id` | string | yes | ID of the bot (hopper) to load the template into. |
| `template_id` | string | yes | ID of the template. |

## Example request

```bash
curl -X POST "https://api.cryptohopper.com/v1/template/TEMPLATE_ID/load/HOPPER_ID" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": "The template has been loaded into the hopper."
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.
