---
title: "Test a new connection url."
method: POST
path: "/v1/connections/test"
tags: ["connectionManagement"]
---

# Test a new connection url.

`POST /v1/connections/test`

Test a new connection url is valid and can connect.

## Query parameters

- `functionalities` string[]
- `connectionId` string

## Request body

- ConnectionDefinition
  - `type` string, required — Type of connection. Valid values are `WebhookDefinition`, `ServiceNowDefinition`.
  - `name` string, required — Name of the connection.
  - `description` string — Description of the connection.

## Response `200`

The connection url has been tested.

- TestConnectionResponse
  - `statusCode` integer, required — Status code of the response of the connection test.
  - `responseContent` string, required — Content of the response of the connection test.
  - `alertStatusCode` integer — Status code of the response of alert payload test.
  - `alertResponseContent` string — Content of the response of alert payload test.
  - `resolutionStatusCode` integer — Status code of the response of resolution payload test.
  - `resolutionResponseContent` string — Content of the response of resolution payload test.

## Other responses

- `default` — Operation failed with an error.

---

[API](https://skmtc.net/sumologic/apis/sumo-logic-api.md) · [All operations](https://skmtc.net/sumologic/apis/sumo-logic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sumologic/sumo-logic-api/revisions/e4e4c7554890/schema)