Account management

Use the Account Management endpoints to create subaccounts, manage emergency contact email addresses, and retrieve ACME contract reporting for subaccounts.

For an overview of the Partner Subscriptions API, see Partner Subscriptions API.

Why use it?

• Create a partner subscriptions subaccount with an API key.
• Retrieve emergency contact email addresses for the authenticated account.
• Add emergency contact email addresses to the authenticated account.
• Remove emergency contact email addresses from the authenticated account.
• Retrieve ACME contract reporting grouped by subaccount.
• Retrieve and update account settings, including the default auto-renewal behavior for new ACME contracts.

Resource URL

Use the Partner Subscriptions API account management resource URL to construct Account Management requests.

https://www.digicert.com/partner-subscription/api/v1/account/

Authentication

Account Management endpoints require authentication with a Partner Subscriptions API key.

Include this header in each request:

X-PARTNER-APIKEY: {{partner_api_key}}

Account hierarchy and API key scope

Account Management endpoints use the account scope of the Partner Subscriptions API key sent in the X-PARTNER-APIKEY header.

Account settings

Use account settings to configure default behavior for the authenticated account.

The auto_renew_subscription setting controls the default auto-renewal behavior for new ACME contracts. When set to 1, new ACME contracts default to auto-renew enabled unless the create request explicitly sets auto_renew to false. When set to 0, new ACME contracts default to auto-renew disabled unless the create request explicitly sets auto_renew to true.

Emergency contact emails

Emergency contact emails are used for critical security issues or service disruptions.

Endpoints in this section

Requests

All Account Management requests use RESTful URLs and header-based authentication. Where a request body is required, the endpoint accepts JSON data.

Methods

Account Management uses these standard HTTP methods:

• GET
• POST
• PUT
• DELETE

Responses

Account Management responses return JSON data unless the endpoint returns 204 No Content.

Common response codes