> For the complete documentation index, see [llms.txt](https://devs.debitdirect.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://devs.debitdirect.io/api/api-reference/agreements/create-agreement.md).

# Create agreement

<mark style="color:green;">`POST`</mark> `https://api.debitdirect.io/agreements`

#### Request Body

| Name                                     | Type       | Description                                                                                                                                                 |
| ---------------------------------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| scheme<mark style="color:red;">\*</mark> | String     | Name of scheme. i.e. 'nets-ls'                                                                                                                              |
| meta<mark style="color:red;">\*</mark>   | Collection | Key-value data for the given scheme. Use [HEAD Get template](/api/api-reference/agreements/get-template.md) request to get a collection for a given scheme. |
| test                                     | Boolean    | Default to false. If true, any associated mandate and payment will be test only.                                                                            |

{% tabs %}
{% tab title="200: OK " %}

```json
{
    "handle": "am_xxxxxxxxxxxxxxxxxx",
    "scheme": "nets-ls",
    "test": true,
    "state": "Pending",
    "metaData": {
        "CreditorNumber": "12345",
        "CvrNumber": "12345678"
    }
}
```

{% endtab %}
{% endtabs %}