Skip to main content

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

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