> For the complete documentation index, see [llms.txt](https://documentation.maax.ai/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.maax.ai/main/technical-guides/apis/v1/goals.md).

# Goals

### /create\_goal/

## Creates a new goal. 

<mark style="color:green;">`POST`</mark>&#x20;

#### Query Parameters

| Name                                          | Type   | Description                                                                                                                                                                                               |
| --------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| title<mark style="color:red;">\*</mark>       | String | Specify the title for the goal. It is used internally by your team only. It will be visible in your dashboard too.                                                                                        |
| description<mark style="color:red;">\*</mark> | String | <p>Free form text that tells MAAX AI what it should achieve. Common uses cases are:<br><br>1. convince the prospect to book a meeting. 2. convince the prospect to purchase the product. </p><p></p>      |
| link                                          | String | <p>A link where MAAX AI should send people to a desired action. For example, it can be a link to your calendar, or a checkout page. <br><br>While not required we highly recommend you include this. </p> |

#### Headers

| Name        | Type   | Description    |
| ----------- | ------ | -------------- |
| 2hd-api-key | String | YOUR\_API\_KEY |

{% tabs %}
{% tab title="200: OK {   "id": NEW\_GOAL\_ID  }" %}

{% endtab %}
{% endtabs %}