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 | optional | string | Public name of the organization. Also called Doing Business As (DBA) name. Character limit: The combined length of the submitted |
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 |
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 Default: |
Response parameters
Name | Type | Description |
---|---|---|
id | integer | ID of the new organization. |