Update organization and technical contact

PUT
https://www.digicert.com/services/v2/organization/{{organization_id}}/contact

Use this endpoint to update or replace the organization contact and technical contact associated with an organization. You can also use this endpoint to remove the technical contact from an organization.

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)
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"
    }
  ]
}'
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": [
    {
      "contact_type": "technical_contact"
    }
  ]
}'
204 No Content
// No content
400 contact_type_duplicate
{
  "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

Name Req/Opt Type Description
organization_id required string Organization ID.

Request parameters

Name Req/Opt Type Description
contacts required array of objects List of contacts. Must include at least one contact object. Limited to one contact of each contact_type.
.. first_name conditional string Contact first name. This field is required when updating or replacing a contact. If removing the technical contact from an organization, omit this field from the contact object.
Character limit: 128
.. last_name conditional string Contact last name. This field is required when updating or replacing a contact. If removing the technical contact from an organization, omit this field from the contact object.
Character limit: 128
.. email conditional string Contact email address. This field is required when updating or replacing a contact. If removing the technical contact from an organization, omit this field from the contact object.
Character limit: 255
.. job_title optional string Contact job title.
Character limit: 64
.. telephone optional string Contact telephone number.
Character limit: 32
.. telephone_extension optional string Contact telephone extension.
Character limit: 16
.. language_id optional string Contact language ID.
Possible values: See Glossary – Locale codes
.. contact_type optional string Contact type.
Allowed values: technical_contact, organization_contact