> For the complete documentation index, see [llms.txt](https://paas.docs.machnetinc.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://paas.docs.machnetinc.com/api-references/webhooks/subscribe.md).

# Subscribe

Create a webhook subscription to receive POST requests from the platform (called webhooks) when events associated with your application occur. Webhooks are sent to a URL which you provide when creating a webhook subscription. 

#### `POST /subscriptions`

{% tabs %}
{% tab title="Request sample" %}

```
curl --location -g --request POST '{{url}}/subscriptions' \
--header 'X-Client-Id: {{client_id}}' \
--header 'X-Client-Secret: {{client_secret}}' \
--header 'Content-Type: application/json' \
--data-raw '{
 
"end_point": "url",
  "secret": "UUID"
  }'
```

{% endtab %}

{% tab title="Response sample" %}

```
[
    {
        "end_point": "url",
        "secret": "UUID",
        "active_from": "2021-03-10 05:49:51",
        "id": "UUID",
        "is_active": true,
        "is_paused": false
    }
]
```

{% endtab %}
{% endtabs %}