Update order contacts

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

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"
    }
  ]
}'

204 No Content

// No content

Path parameters

NameReq/OptTypeDescription
order_idrequiredstringOrder ID.

Request parameters

NameReq/OptTypeDescription
contactsrequiredarray of objectsList of order-level contacts. Must include at least one contact object. Limited to one contact of each contact_type.
.. contact_typerequiredstringContact type.
Allowed values: technical_contact, organization_contact
.. first_namerequiredstringContact first name.
Character limit: 128
.. last_namerequiredstringContact last name.
Character limit: 128
.. emailrequiredstringContact email address.
Character limit: 255
.. job_titleoptionalstringContact job title.
Character limit: 64
.. telephoneoptionalstringContact telephone number.
Character limit: 32
.. language_idoptionalstringContact language ID.
Possible values: See Glossary – Locale codes.