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

Example 1. cURL

curl -X POST \
  https://www.digicert.com/services/v2/organization \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "name": "Epigyne Unwieldiness llc",
    "assumed_name": "Epigyne Unwieldiness",
    "country": "us",
    "address": "932 Prospect Street",
    "address2": "Floor 08",
    "city": "Minneapolis",
    "state": "Minnesota",
    "zip": "40849",
    "telephone": "666-186-6450",
    "organization_contact": {
        "first_name": "Gia",
        "last_name": "Booth",
        "job_title": "Clinical Laboratory Technician",
        "email": "gia.booth@inbox.com",
        "telephone": "666-186-6450",
        "telephone_extension": "736"
    }
}'

Example 2. Python

import requests

url = "https://www.digicert.com/services/v2/organization"

payload = "{\n    \"name\": \"Epigyne Unwieldiness llc\",\n    \"assumed_name\": \"Epigyne Unwieldiness\",\n    \"country\": \"us\",\n    \"address\": \"932 Prospect Street\",\n    \"address2\": \"Floor 08\",\n    \"city\": \"Minneapolis\",\n    \"state\": \"Minnesota\",\n    \"zip\": \"40849\",\n    \"telephone\": \"666-186-6450\",\n    \"organization_contact\": {\n        \"first_name\": \"Gia\",\n        \"last_name\": \"Booth\",\n        \"job_title\": \"Clinical Laboratory Technician\",\n        \"email\": \"gia.booth@inbox.com\",\n        \"telephone\": \"666-186-6450\",\n        \"telephone_extension\": \"736\"\n    }\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Example 3. Go

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.digicert.com/services/v2/organization"

	payload := strings.NewReader("{\n    \"name\": \"Epigyne Unwieldiness llc\",\n    \"assumed_name\": \"Epigyne Unwieldiness\",\n    \"country\": \"us\",\n    \"address\": \"932 Prospect Street\",\n    \"address2\": \"Floor 08\",\n    \"city\": \"Minneapolis\",\n    \"state\": \"Minnesota\",\n    \"zip\": \"40849\",\n    \"telephone\": \"666-186-6450\",\n   
 \"organization_contact\": {\n        \"first_name\": \"Gia\",\n        \"last_name\": \"Booth\",\n        \"job_title\": \"Clinical Laboratory Technician\",\n        \"email\": \"gia.booth@inbox.com\",\n        \"telephone\": \"666-186-6450\",\n        \"telephone_extension\": \"736\"\n    }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

Example 4. NodeJS

var request = require("request");

var options = { method: 'POST',
  url: 'https://www.digicert.com/services/v2/organization',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { name: 'Epigyne Unwieldiness llc',
     assumed_name: 'Epigyne Unwieldiness',
     country: 'us',
     address: '932 Prospect Street',
     address2: 'Floor 08',
     city: 'Minneapolis',
     state: 'Minnesota',
     zip: '40849',
     telephone: '666-186-6450',
     organization_contact: 
      { first_name: 'Gia',
        last_name: 'Booth',
        job_title: 'Clinical Laboratory Technician',
        email: 'gia.booth@inbox.com',
        telephone: '666-186-6450',
        telephone_extension: '736' } },
  json: true };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

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.

In this section: