Skip to main content

Create organization

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

Use this endpoint to create a new organization.

When you use this endpoint, we check 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.

Notice

Submitted organization information will be validated by DigiCert and may appear on certificates.

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

conditional

string

Job title of the contact. Required for the contact to be an EV approver.

Character limit: 64

.. email

required

string

Email address that can be used to reach contact.

Character limit: 255

.. telephone

conditional

string

Telephone number that can be used to reach the contact. Required for contact to be an EV approver.

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

Response parameters

Name

Type

Description

id

integer

ID of the new organization.