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

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

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

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`

In this section: