---
title: "Upload certificate"
method: POST
path: "/subscriptions/1/certificates"
tags: ["platform", "subscriptions-api", "certificate"]
---

# Upload certificate

`POST /subscriptions/1/certificates`

## 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`
- 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

Upload the certificate Infobip will present for your webhook to verify Infobip when sending notification events.

## Request body

- 6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33fCertificateUploadRequest
  - `certificateId` string, required: Certificate's identifier. Must contain only alphanumeric characters, dots, hyphens, and underscores (pattern: `[a-zA-Z0-9._-]`). This identifier will be used as part of a URL path. You cannot change the ID once an item is created.
  - `certificateContent` string, base64, required: Content of a .pem file encoded in Base64 format.
  - `passphrase` string, base64: Certificate's passphrase encoded in Base64 format.

## Response `201`

Created.

- 6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33fCertificateStatusResponse
  - `certificateId` string: Certificate identifier.
  - `status` 'PROCESSING' | 'READY' | 'EXPIRED': Certificate status. Represents a certificate state and indicates whether the certificate can be used. PROCESSING means certificate is being synced on Infobip Platform and cannot be use for notification events. READY means certificate is synced and notification events can be sent to webhook using the certificate. EXPIRED means certificate cannot be used because validity date is in the past.

## 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)