Create organization

6 minute read

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.

Note

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

curl -X POST \
  https://www.digicert.com/services/v2/organization \
  --header 'Content-Type: application/json' \
  --header 'X-DC-DEVKEY: {{api_key}}' \
  --data-raw '{
    "name": "Example Organization, LLC",
    "assumed_name": "Example Organization",
    "country": "us",
    "address": "ABC Movers",
    "address2": "Floor 08",
    "city": "Springfield",
    "state": "Virginia",
    "zip": "22162",
    "telephone": "555-555-0100",
    "organization_contact": {
        "first_name": "Jane",
        "last_name": "Doe",
        "job_title": "Manager",
        "email": "jane.doe@example.com",
        "telephone": "555-555-0100",
        "telephone_extension": "736"
    }
}'

curl -X POST \
  https://www.digicert.com/services/v2/organization \
  --header 'Content-Type: application/json' \
  --header 'X-DC-DEVKEY: {{api_key}}' \
  --data-raw '{
    "name": "Example Organization, LLC",
    "assumed_name": "Example Organization",
    "country": "us",
    "address": "ABC Movers",
    "address2": "Floor 08",
    "city": "Springfield",
    "state": "Virginia",
    "zip": "22162",
    "telephone": "555-555-0100",
    "organization_contact": {
        "first_name": "Jane",
        "last_name": "Doe",
        "job_title": "Manager",
        "email": "jane.doe@example.com",
        "telephone": "555-555-0100",
        "telephone_extension": "736"
    },
    "validations": [
      {
        "type": "ov"
      },
      {
        "type": "ev",
        "verified_users": [
          {
            "id": 7286246
          },
          {
            "first_name": "John",
            "last_name": "Doe",
            "job_title": "Site Reliability Engineer",
            "telephone": "555-555-1001",
            "email": "john.doe@example.com"
          }
        ]
      }
    ]
}'

201 Created

{
  "id": 112236
}

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: 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.

Was this page helpful?

Provide feedback

Need more help?

Account and platform

Certificates and PKI

Signing

Devices and IoT

Other resources

Create organization

Note

Organization validation process

Note

Skip duplicate organization check

Example requests and responses

201 Created

Request parameters

Response parameters