---
title: "Update organization and technical contact"
source_url: https://dev.digicert.com/certcentral-apis/services-api/organizations/update-organization-and-technical-contact.html
api_method: PUT
api_endpoint: "/services/v2/organization/{{organization_id}}/contact"
api_url: "https://www.digicert.com/services/v2/organization/{{organization_id}}/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)**

```bash
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)**

```bash
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**

```json
// No content
```

**400 Bad Request (contact_type_duplicate)**

```json
{
  "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

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>organization_id</td>
<td>required</td>
<td>string</td>
<td>Organization ID.</td>
</tr>
</tbody>
</table>

## Request parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>contacts</td>
<td>required</td>
<td>array of objects</td>
<td>List of contacts. Must include at least one contact object. Limited to one contact of each <code>contact_type</code>.</td>
</tr>
<tr>
<td>.. first_name</td>
<td>conditional</td>
<td>string</td>
<td>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.<br><strong>Character limit:</strong> 128</td>
</tr>
<tr>
<td>.. last_name</td>
<td>conditional</td>
<td>string</td>
<td>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.<br><strong>Character limit:</strong> 128</td>
</tr>
<tr>
<td>.. email</td>
<td>conditional</td>
<td>string</td>
<td>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.<br><strong>Character limit:</strong> 255</td>
</tr>
<tr>
<td>.. job_title</td>
<td>optional</td>
<td>string</td>
<td>Contact job title.<br><strong>Character limit:</strong> 64</td>
</tr>
<tr>
<td>.. telephone</td>
<td>optional</td>
<td>string</td>
<td>Contact telephone number.<br><strong>Character limit:</strong> 32</td>
</tr>
<tr>
<td>.. telephone_extension</td>
<td>optional</td>
<td>string</td>
<td>Contact telephone extension.<br><strong>Character limit:</strong> 16</td>
</tr>
<tr>
<td>.. language_id</td>
<td>optional</td>
<td>string</td>
<td>Contact language ID.<br><strong>Possible values:</strong> See <a href="https://dev.digicert.com/md/certcentral-apis/services-api/glossary.md#locale-codes">Glossary – Locale codes</a>.</td>
</tr>
<tr>
<td>.. contact_type</td>
<td>optional</td>
<td>string</td>
<td>Contact type.<br><strong>Allowed values:</strong> <code>technical_contact</code>, <code>organization_contact</code></td>
</tr>
</tbody>
</table>