Skip to main content

Update organization and technical contact for an order

PUT https://www.digicert.com/services/v2/order/certificate/{{order_id}}/contact

Use this endpoint to update the order-level organization and technical contact for the given certificate order.

This endpoint supports the following operations:

  • Add an order-level technical contact.

  • Replace or modify the existing order-level technical contact.

  • Replace or modify the existing order-level organization contact.

Usage and limitations

  • This endpoint can only add, replace, and modify contacts. The Services API does not support removing organization or technical contacts from an order.

  • An order can have only one organization contact and one technical contact. In your request body, the contacts array can include only one contact of each contact_type.

  • DV TLS/SSL orders cannot have order-level organization contacts. If you provide an organization contact in your request to edit contacts on a DV TLS order, the API returns an error.

  • DigiCert does not update contact types omitted from your request. For example, if your request includes a single contact object with a contact_type of organization_contact, we only update the organization contact for the order. The technical contact for the order remains unchanged.

  • Omitting optional fields from a contact object leaves existing values for those fields unchanged.

Example requests and responses

Example 1. Update contacts (cURL)
curl --request PUT 'https://www.digicert.com/services/v2/order/certificate/{{order_id}}/contact' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "contacts": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@example.com",
      "job_title": "SRE",
      "telephone": "1234567890",
      "language_id": "1",
      "contact_type": "organization_contact"
    },
    {
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane.doe@example.com",
      "job_title": "SRE",
      "telephone": "1234567890",
      "language_id": "1",
      "contact_type": "technical_contact"
    }
  ]
}'

Path parameters

Name

Req/Opt

Type

Description

order_id

required

string

Order ID.

Request parameters

Name

Req/Opt

Type

Description

contacts

required

array of objects

List of order-level contacts. Must include at least one contact object. Limited to one contact of each contact_type.

.. contact_type

required

string

Contact type.

Allowed values: technical_contact, organization_contact

.. first_name

required

string

Contact first name.

Character limit: 128

.. last_name

required

string

Contact last name.

Character limit: 128

.. email

required

string

Contact email address.

Character limit: 255

.. job_title

optional

string

Contact job title.

Character limit: 64

.. telephone

optional

string

Contact telephone number.

Character limit: 32

.. language_id

optional

string

Contact language ID.

Possible values: See Glossary – Locale codes.

In this section: