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.
contacts
array can include only one contact of each contact_type
.contact_type
of organization_contact
, we only update the organization contact. We do not update the technical contact associated with the organization.contact_type
of technical_contact
. Omit all other fields from the contact object.contacts
array should include a value for all fields you want to change and all fields you want to keep the same (if any).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"
}
]
}'
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"
}
]
}'
// No content
{
"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."
}
]
}
Name | Req/Opt | Type | Description |
---|---|---|---|
organization_id | required | string | Organization ID. |
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 |
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
|