---
title: "Register of certificate action callback"
method: PUT
path: "/v1/certificates/{certificateId}/callback"
tags: ["v1"]
---

# Register of certificate action callback

`PUT /v1/certificates/{certificateId}/callback`

This method is used to register/replace url for callbacks for stateful actions relating to a certificate lifecycle. The callback url is a Webhook style pattern and will receive POST http requests with json body defined in the CertificateAction model definition for each certificate action.  Only one callback URL is allowed to be registered for each certificateId, so it will replace a previous registration.

## Path parameters

- `certificateId` string, required

## Query parameters

- `callbackUrl` string, required

## Response `204`

Callback replaced/registered

## Other responses

- `400` — Request was malformed
- `401` — Authentication info not sent or invalid
- `403` — Authenticated user is not allowed access
- `404` — Certificate id not found
- `422` — Callback url is missing <br> Callback url is malformed
- `500` — Internal server error

---

[API](https://skmtc.net/godaddy/apis/untitled-api-2.md) · [All operations](https://skmtc.net/godaddy/apis/untitled-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/godaddy/untitled-api-2/revisions/100b3aa2d7ee/schema)