Need help? Call Live Support at +31 (0) 38 453 07 59

Attention! You're currently using the OT&E environment.

Used to create a new certificate

Deprecated This API call is deprecated. You are strongly advised not to use this call anymore. Instead, switch to the Request Certificate call, which provides the functionality of this call, and more.
  • POSTMethod
  • /v2/customers/customer/certificatesURL
  • application/jsonContent-Type
Name Type Description Restrictions
customer String The handle of the customer
  • Regular expression: [a-zA-Z0-9\-_@\.]+
  • Minimum length: 3
  • Maximum length: 40
Name Type Required / Optional Description Restrictions
quote Boolean Optional If true, validate the request and request a quote for the action
Name Type Required / Optional Description Restrictions
product Enum Required The product defines the type of certificate to create

Possible values:

  • ssl_comodo_positive: PositiveSSL
  • ssl_comodo_positive_wc: PositiveSSL wildcard
  • ssl_comodo_instant: InstantSSL
  • ssl_comodo_instant_wc: InstantSSL wildcard
  • ssl_comodo_ev: Extended validation
contact String Optional The contact handle to use for the certificate, not required when the certificate is for a domain that is managed by Realtime Register. The information of the contact has to match the information specified in the CSR
  • Regular expression: [a-zA-Z0-9\-_@\.]+
  • Minimum length: 3
  • Maximum length: 40
period Integer Required The validity period of the certificate in years

Possible values:

  • 1
  • 2
  • 3
  • 4
  • 5
csr String Required A valid Certificate Signing Request
validationMethod Enum Required The validation type used for the certificate request

Possible values:

  • Provider specific. Refer to provider metadata for possible values:
properties Map <String, String> Required Provider specific properties. Look here for an overview of possible properties.
provider String Required The name of the provider
billables List < billables > Optional Acknowledgment of billables for this request
Name Type Required / Optional Description Restrictions
product String Required The product
action Enum Required The action

Possible values:

  • CREATE
  • REQUEST
  • TRANSFER
  • RENEW
  • RESTORE
  • TRANSFER_RESTORE
  • UPDATE
  • REGISTRANT_CHANGE
  • LOCAL_CONTACT
  • NEGATIVE_MARKUP
  • PRIVACY_PROTECT
  • EXTRA_WILDCARD
  • EXTRA_DOMAIN
  • REGISTRY_LOCK
quantity Integer Optional The maximum quantity, default 1

Successful request

  • 202 AcceptedHTTP Status

Failed requests

Besides the generic errors these specific error responses can be expected.

Type Status Description
BillableAcknowledgmentNeededException 400 Bad Request
The handle of the customer
If true, validate the request and request a quote for the action
The product defines the type of certificate to create
The contact handle to use for the certificate, not required when the certificate is for a domain that is managed by Realtime Register. The information of the contact has to match the information specified in the CSR
The validity period of the certificate in years
A valid Certificate Signing Request
The validation type used for the certificate request
The name of the provider

Provider specific properties. Look here for an overview of possible properties.

The product
The action
The maximum quantity, default 1

POST /v2/customers/customer/certificates
Content-Type: application/json

{}