Skip to main content

Create organization

POST https://www.digicert.com/services/v2/organization

Use this endpoint to create a new organization in your CertCentral account. When you create an organization, the API returns an organization ID you can use in certificate order requests.

Notice

The organization information you submit will be validated by DigiCert and may appear on certificates.

Organization validation process

For OV and EV TLS/SSL, Private SSL, Code Signing, Verified Mark Certificate (VMC), and Document Signing certificate orders, the certificate’s validation process includes organization validation and verifying the organization contact. DigiCert must complete this process before issuing the certificate.

To quicken the certificate issuance process, you can submit an organization for prevalidation. In the Services API, there are two ways to submit an organization for prevalidation:

  • Submit the organization for validation when creating the organization.

    If you know the intended use of the organization, submit the organization to be validated with the same API request that creates the organization. This reduces the number of API calls needed to prevalidate the organization. To do this, include the validations array in your request to create the organization. For examples, see Example requests and responses below.

  • Submit the organization for validation after creating the organization.

    If you create an organization without knowing its intended use, you can submit the organization for prevalidation later. Do this by using the Submit organization for validation endpoint.

Note

You cannot prevalidate an organization for VMC certificate issuance.

If you don't prevalidate an organization, you can still use the organization ID in your certificate order requests. For these organizations, DigiCert starts the validation process when you create the certificate order.

Skip duplicate organization check

When you create an organization, DigiCert checks the organizations that already exist in your account to avoid creating a duplicate organization. If the details in a Create organization request match the details of an existing organization, the request returns an error.

To override this behavior and force the request to create a new organization, set the organization.skip_duplicate_org_check parameter to true in the body of your request.

Example requests and responses

Request parameters

Name

Req/Opt

Type

Description

name

required

string

Legal name of the organization.

Character limit: 64 if assumed_name is empty or not provided. If the request includes an assumed_name value, the combined length of the submitted name + assumed_name values cannot exceed 61 characters. Three characters are reserved for spacing and punctuation.

assumed_name

optional

string

Public name of the organization. Also called Doing Business As (DBA) name.

Character limit: The combined length of the submitted name + assumed_name values cannot exceed 61 characters. Three characters are reserved for spacing and punctuation.

country

required

string

Two-letter country code for the country where the organization is located.

Format: Must be a valid ISO 3166-1 alpha-2 code.

address

required

string

Address of the organization.

Character limit: 64

address2

optional

string

Second line of the organization's address.

Character limit: 64

city

required

string

City where the organization is located.

Character limit: 64

state

required

string

State or province where the organization is located. Use the full name instead of an abbreviation.

Character limit: 64

zip

required

string

Postal code of the organization.

Character limit: 40

telephone

required

string

Organization telephone number.

Character limit: 32

organization_contact

required

object

Object with information about the organization contact.

.. first_name

required

string

First name of the contact.

Character limit: 128

.. last_name

required

string

Last name of the contact.

Character limit: 128

.. job_title

optional

string

Job title of the contact.

Character limit: 64

.. email

required

string

Email address that can be used to reach contact.

Character limit: 255

.. telephone

optional

string

Telephone number that can be used to reach the contact.

Character limit: 32

.. telephone_extension

optional

string

Phone extension of the contact.

Character limit: 16

skip_duplicate_org_check

optional

boolean

Use true to skip the check for duplicate organizations in your account. When you skip this check, you force the request to create a new organization, regardless of whether the details you provide in the request match the details of an organization that already exists in your account.

Default: false

validations

optional

array

If you are submitting the organization for validation with your request to create the organization, provide a list of validation objects for each validation type.

.. type

required

string

Validation type identifier.

Possible values:

  • ov: Normal Organization Validation

  • ev Extended Organization Validation

  • cs: Code Signing Organization Validation

  • ev_cs: Code Signing Organization Extended Validation

  • ds: Document Signing Validation

  • smime: SMIME Organization Validation

See also: Glossary – Validation types.

.. verified_users

conditional

array

List of one or more verified contacts for the corresponding validation type. You can add an existing CertCentral user as a verified contact, or you can add a non-CertCentral account user as a verified contact (see Enable adding non-CertCentral account users as verified contacts).

Required if the validation type is ev, cs, or ev_cs. Not used for other validation types.

.. .. id

conditional

integer

If adding an existing CertCentral user as a verified contact, provide the user ID.

Required if adding an existing user as the verified contact. If included, other contact parameters are ignored.

.. .. first_name

conditional

integer

First name of the verified contact.

Required if adding a non-CertCentral account user as a verified contact (id parameter is omitted).

Character limit: 128

.. .. last_name

conditional

integer

Last name of the verified contact.

Required if adding a non-CertCentral account user as a verified contact (id parameter is omitted).

Character limit: 128

.. .. job_title

conditional

string

Job title of the verified contact.

Required if adding a non-CertCentral account user as a verified contact (id parameter is omitted).

Character limit: 64

.. .. telephone

conditional

string

Telephone number of the verified contact.

Required if adding a non-CertCentral account user as a verified contact (id parameter is omitted).

Character limit: 32

.. .. telephone_extension

optional

string

Phone extension of the contact.

Character limit: 16

.. .. email

conditional

string

Email address of the verified contact.

Required if adding a non-CertCentral account user as a verified contact (id parameter is omitted).

Character limit: 255

Response parameters

Name

Type

Description

id

integer

ID of the new organization.