---
title: "Test connection to a webhook"
method: POST
path: "/subscriptions/1/certificates/test/webhook"
tags: ["platform", "subscriptions-api", "certificate"]
---

# Test connection to a webhook

`POST /subscriptions/1/certificates/test/webhook`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/subscriptions/1/certificates/test/webhook`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Performs connectivity check to provided webhook with the given certificate. Note, it does not send a notification event.

## Request body

- 6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33fCertificateConnectionTestRequest
  - `certificateId` string, required: Existing certificate identifier.
  - `webhookUrl` string, required: A webhook URL over which a connectivity test will be performed.

## Response `200`

Success.

- 6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33fCertificateConnectionTestResponse
  - `certificateId` string: Existing certificate identifier.
  - `webhookUrl` string: A webhook URL over which a connectivity test will be performed.
  - `result` 'SUCCESS' | 'FAIL': Connection test result. Indicates whether the test to connection passed.
  - `failReasons` string[]: Contains reasons why the connection test was failed.
  - `hint` string: Contains a hint how the client can fix the errors.

## Other responses

- `400`: Bad request.
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found.
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)
