Set Certificate Issuer - Set Certificate Issuer

Service:

Key Vault

API Version:

2025-07-01

Sets the specified certificate issuer.
The SetCertificateIssuer operation adds or updates the specified certificate issuer. This operation requires the certificates/setissuers permission.

PUT {vaultBaseUrl}/certificates/issuers/{issuer-name}?api-version=2025-07-01

URI Parameters

Name	In	Required	Type	Description
issuer-name	path	True	string	The name of the issuer. The value you provide may be copied globally for the purpose of running the service. The value provided should not include personally identifiable or sensitive information.
vaultBaseUrl	path	True	string (uri)
api-version	query	True	string minLength: 1	The API version to use for this operation.

Request Body

Name	Required	Type	Description
provider	True	string	The issuer provider.
attributes		IssuerAttributes	Attributes of the issuer object.
credentials		IssuerCredentials	The credentials to be used for the issuer.
org_details		OrganizationDetails	Details of the organization as provided to the issuer.

Responses

Name	Type	Description
200 OK	IssuerBundle	The request has succeeded.
Other Status Codes	KeyVaultError	An unexpected error response.

Security

OAuth2Auth

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
https://vault.azure.net/.default

Examples

SetCertificateIssuer

Sample request

HTTP

PUT https://myvault.vault.azure.net//certificates/issuers/issuer01?api-version=2025-07-01

{
  "provider": "Test",
  "credentials": {
    "account_id": "keyvaultuser",
    "pwd": "password"
  },
  "org_details": {
    "admin_details": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "email": "admin@microsoft.com",
        "phone": "4255555555"
      }
    ]
  }
}

Sample response

Status code:

200

{
  "id": "https://myvault.vault.azure.net/certificates/issuers/issuer01",
  "provider": "Test",
  "credentials": {
    "account_id": "keyvaultuser"
  },
  "org_details": {
    "admin_details": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "email": "admin@microsoft.com",
        "phone": "4255555555"
      }
    ]
  },
  "attributes": {
    "enabled": true,
    "created": 1482188806,
    "updated": 1482189526
  }
}

Definitions

Name	Description
AdministratorDetails	Details of the organization administrator of the certificate issuer.
CertificateIssuerSetParameters	The certificate issuer set parameters.
Error
IssuerAttributes	The attributes of an issuer managed by the Key Vault service.
IssuerBundle	The issuer for Key Vault certificate.
IssuerCredentials	The credentials to be used for the certificate issuer.
KeyVaultError	The key vault error exception.
OrganizationDetails	Details of the organization of the certificate issuer.

AdministratorDetails

Object

Details of the organization administrator of the certificate issuer.

Name	Type	Description
email	string	Email address.
first_name	string	First name.
last_name	string	Last name.
phone	string	Phone number.

CertificateIssuerSetParameters

Object

The certificate issuer set parameters.

Name	Type	Description
attributes	IssuerAttributes	Attributes of the issuer object.
credentials	IssuerCredentials	The credentials to be used for the issuer.
org_details	OrganizationDetails	Details of the organization as provided to the issuer.
provider	string	The issuer provider.

Error

Object

Name	Type	Description
code	string	The error code.
innererror	Error	The key vault server error.
message	string	The error message.

IssuerAttributes

Object

The attributes of an issuer managed by the Key Vault service.

Name	Type	Description
created	integer (unixtime)	Creation time in UTC.
enabled	boolean	Determines whether the issuer is enabled.
updated	integer (unixtime)	Last updated time in UTC.

IssuerBundle

Object

The issuer for Key Vault certificate.

Name	Type	Description
attributes	IssuerAttributes	Attributes of the issuer object.
credentials	IssuerCredentials	The credentials to be used for the issuer.
id	string	Identifier for the issuer object.
org_details	OrganizationDetails	Details of the organization as provided to the issuer.
provider	string	The issuer provider.

IssuerCredentials

Object

The credentials to be used for the certificate issuer.

Name	Type	Description
account_id	string	The user name/account name/account id.
pwd	string	The password/secret/account key.

KeyVaultError

Object

The key vault error exception.

Name	Type	Description
error	Error	The key vault server error.

OrganizationDetails

Object

Details of the organization of the certificate issuer.

Name	Type	Description
admin_details	AdministratorDetails[]	Details of the organization administrator.
id	string	Id of the organization.