---
title: "Update order contacts"
source_url: https://dev.digicert.com/certcentral-apis/services-api/orders/update-order-contacts.html
api_method: PUT
api_endpoint: "/services/v2/order/certificate/{{order_id}}/contact"
api_url: "https://www.digicert.com/services/v2/order/certificate/{{order_id}}/contact"
---

**PUT** `https://www.digicert.com/services/v2/order/certificate/{{order_id}}/contact`

Use this endpoint to update the order-level organization and technical contact for the given certificate order.

This endpoint supports the following operations:

- Add an order-level technical contact.
- Replace or modify the existing order-level technical contact.
- Replace or modify the existing order-level organization contact.

## Usage and limitations

- This endpoint can only add, replace, and modify contacts. The Services API does not support removing organization or technical contacts from an order.
- An order can have only one organization contact and one technical contact. In your request body, the `contacts` array can include only one contact of each `contact_type`.
- DV TLS/SSL orders cannot have order-level organization contacts. If you provide an organization contact in your request to edit contacts on a DV TLS order, the API returns an error.
- 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 for the order. The technical contact for the order remains unchanged.
- Omitting optional fields from a `contact` object leaves existing values for those fields unchanged.

## Example requests and responses

## Update contacts (cURL)

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

## 204 No Content

```json
// No content
```

## 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>order_id</td>
<td>required</td>
<td>string</td>
<td>Order 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 order-level contacts. Must include at least one contact object. Limited to one contact of each <code>contact_type</code>.</td>
</tr>
<tr>
<td>.. contact_type</td>
<td>required</td>
<td>string</td>
<td>Contact type.<br><strong>Allowed values:</strong> <code>technical_contact</code>, <code>organization_contact</code></td>
</tr>
<tr>
<td>.. first_name</td>
<td>required</td>
<td>string</td>
<td>Contact first name.<br><strong>Character limit:</strong> 128</td>
</tr>
<tr>
<td>.. last_name</td>
<td>required</td>
<td>string</td>
<td>Contact last name.<br><strong>Character limit:</strong> 128</td>
</tr>
<tr>
<td>.. email</td>
<td>required</td>
<td>string</td>
<td>Contact email address.<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>.. 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>
</tbody>
</table>