---
title: "Send notification URL via POST"
method: GET
path: "/send_test_posturl"
tags: ["Server Administration", "Notifications"]
---

# Send notification URL via POST

`GET /send_test_posturl`

This function uses the specified URL to send a test message through the POST method of HTTP as form data.
The function automatically generates a message title and body and includes a unique string in the test message.
When the test message returns, the system searches for the ID string and returns it.

If the function does not detect the correct ID string in the returned message, the function fails.

The test's success or failure depends on various conditions. For example:
* Valid access token.
* Network configuration.
* Service outages.
* External server rate limit.

## Query parameters

- `url` string, required

## Response `200`

HTTP Request was successful.

- object
  - `data` object
    - `message_id` string — The test message's ID.
  - `metadata` object
    - `command` string — The method name called.
    - `reason` string — The reason the API function failed when the `metadata.result` field is 0. This field may display a success message when a function succeeds.
    - `result` 0 | 1 — * `1` - Success * `0` - Failed: Check the reason field for more details.
    - `version` integer — The version of the API function.

---

[API](https://skmtc.net/cpanel/apis/whm-api.md) · [All operations](https://skmtc.net/cpanel/apis/whm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cpanel/whm-api/revisions/3da41671c02c/schema)