Update organization and technical contact

This endpoint updates contacts at the organization level only. It does not change contacts associated with existing certificate orders.

Usage and limitations

• An organization can have only one organization contact and one technical contact. In your JSON request body, the contacts array can include only one contact of each contact_type.
• 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. We do not update the technical contact associated with the organization.
• To remove the technical contact from the organization, submit a contact object with a contact_type of technical_contact. Omit all other fields from the contact object.
• You cannot remove the organization contact from an organization.
• When you submit a request to this endpoint, DigiCert compares the contacts in your request to the contacts currently assigned to the organization.
  • We update the contact in-place if the submitted contact’s first name, last name, and email address match the current contact.
  • We create a new contact if the submitted contact’s first name, last name, or email address do not match the current contact. The new contact replaces the existing contact for the organization.
• Omitting optional fields from a contact object deletes existing values for those fields. Each contact object in your contacts array should include a value for all fields you want to change and all fields you want to keep the same (if any).

Example requests and responses

• Update contacts (cURL)
• Remove technical contact (cURL)

curl --request PUT 'https://www.digicert.com/services/v2/organization/{{organization_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",
      "telephone_extension": "1234",
      "language_id": "1",
      "contact_type": "organization_contact"
    },
    {
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane.doe@example.com",
      "job_title": "SRE",
      "telephone": "1234567890",
      "telephone_extension": "1234",
      "language_id": "1",
      "contact_type": "technical_contact"
    }
  ]
}'

curl --request PUT 'https://www.digicert.com/services/v2/organization/{{organization_id}}/contact' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "contacts": [
    {
      "contact_type": "technical_contact"
    }
  ]
}'

• 204 No Content
• 400 Bad Request (contact_type_duplicate)

// No content

{
  "errors": [
    {
      "code": "contact_type_duplicate",
      "message": "A duplicate contact type was submitted. Make sure your request includes no more than one of each contact type and try again."
    }
  ]
}

Path parameters

Request parameters