--- updatedAt: 2026-03-01T18:21:54.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/etp-config/llms.txt --- # Create a new proxy certificate Creates a new proxy certificate. # OpenAPI definition ```json { "externalDocs": { "description": "See documentation for Akamai's Secure Internet Access Enterprise Configuration API", "url": "https://techdocs.akamai.com/etp-config/reference" }, "info": { "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "title": "Certificates", "version": "v3" }, "openapi": "3.0.0", "paths": { "/customers/{configId}/certificates": { "post": { "description": "Creates a new proxy certificate.", "externalDocs": { "description": "See documentation for this operation in Akamai's Secure Internet Access Enterprise Configuration API", "url": "https://techdocs.akamai.com/etp-config/reference/post-customers-certificate" }, "operationId": "post-customers-certificate", "parameters": [ { "description": "For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).", "in": "query", "name": "accountSwitchKey", "required": false, "schema": { "example": "1-5C0YLB:1-8BYUX", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "caMode": "AKAMAI", "certificate": "-----BEGIN CERTIFICATE-----\nMIIDpjCCAo6gAwIBAgIIf8Ji8Dm81ko ... TXV0qe8SEF+C5n4=\n-----END CERTIFICATE-----" }, "schema": { "additionalProperties": false, "description": "Contains data about a TLS certificate.", "properties": { "caMode": { "description": "Mode of the certificate, either `CUSTOMER` or `AKAMAI`.", "enum": [ "CUSTOMER", "AKAMAI" ], "type": "string" }, "certificate": { "description": "Value of the certificate in PEM format. ASCII, base64-encoded text starting with `-----BEGIN CERTIFICATE-----` and ending with `-----END CERTIFICATE-----`.", "type": "string" }, "certificateId": { "description": "__Read-only__ A unique identifier for each certificate.", "minimum": 1, "readOnly": true, "type": "integer" }, "certificateRequest": { "description": "Value for the certificate signing request (CSR). ASCII, base64-encoded text starting with `-----BEGIN CERTIFICATE REQUEST-----` and ending with `-----END CERTIFICATE REQUEST-----`.", "format": "byte", "type": "string" }, "createdBy": { "description": "Name of the user who created this certificate.", "minLength": 1, "type": "string" }, "createdDate": { "description": "__Read-only__ ISO 8601 timestamp marking the certificate's creation.", "format": "date-time", "readOnly": true, "type": "string" }, "expiredDate": { "description": "__Read-only__ ISO 8601 timestamp marking the certificate's expiration.", "format": "date-time", "readOnly": true, "type": "string" }, "fingerprint": { "description": "The certificate's hexadecimal fingerprint.", "minLength": 1, "type": "string" }, "issuedDate": { "description": "__Read-only__ ISO 8601 timestamp marking the certificate's issue.", "format": "date-time", "readOnly": true, "type": "string" }, "modifiedBy": { "description": "Name of the user who most recently modified this certificate. If there haven't been any modifications, the value matches `createdBy`.", "minLength": 1, "type": "string" }, "modifiedDate": { "description": "__Read-only__ ISO 8601 timestamp marking this certificate's last modification. If there haven't been any modifications, the value matches `createdDate`.", "format": "date-time", "readOnly": true, "type": "string" }, "status": { "description": "__Read-only__ The certificate's deployment status. Either `CREATING`, `UPDATING`, `PENDING_DOWNLOAD`, `PENDING_DISTRIBUTION`, `PENDING_ACTIVATION`, `ACTIVATING`, `ACTIVATED`, `DEACTIVATING`, `DEACTIVATED`, `EXPIRED` or `INCOMPLETE`.", "enum": [ "CREATING", "UPDATING", "PENDING_DOWNLOAD", "PENDING_DISTRIBUTION", "PENDING_ACTIVATION", "ACTIVATING", "ACTIVATED", "DEACTIVATING", "DEACTIVATED", "EXPIRED", "INCOMPLETE" ], "readOnly": true, "type": "string" } }, "required": [ "certificate", "caMode" ], "type": "object", "x-akamai": { "file-path": "schemas/certificate.yaml" } } } }, "required": true }, "responses": { "201": { "content": {}, "description": "Successful response.", "headers": { "Location": { "description": "Location URL for the newly created resource.", "schema": { "example": "https://xyzcorp.akamai.com/etp-config/v3/configs/238461/sites/304204", "type": "string" }, "x-akamai": { "file-path": "headers/location-header.yaml" } } } }, "400": { "content": { "application/problem+json": { "example": { "detail": "object has missing required properties ([\"exitPoints\",\"name\"])", "instance": "233ecac0-074b-4d7f-a352-375636ecf2a9", "status": 400, "title": "Bad Request", "type": "https://problems.omni.akamaiapis.net/http/bad-request" }, "schema": { "additionalProperties": true, "description": "The problem indicated by the error response from the SIA Config API.", "properties": { "detail": { "description": "A human-readable explanation specific to the problem.", "minLength": 1, "type": "string" }, "errors": { "description": "A list of HTTP problem details. The error response includes this list if there are several problems with a single request, to call out each of them separately.", "items": { "description": "A nested problem object.", "type": "object", "x-akamai": { "file-path": "schemas/problem-nested.yaml" } }, "minItems": 0, "type": "array" }, "instance": { "description": "The URI for this error occurrence.", "type": "string" }, "status": { "description": "The HTTP status code generated by the origin server.", "minimum": 0, "type": "integer" }, "title": { "description": "A short, human-readable summary of the problem type.", "minLength": 1, "type": "string" }, "type": { "description": "A URI reference that identifies the problem type.", "minLength": 1, "type": "string" } }, "required": [ "type", "title", "detail", "instance", "status" ], "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Validation error.](https://techdocs.akamai.com/etp-config/reference/400)", "x-akamai": { "file-path": "errors/validation-error-400.yaml" } }, "401": { "content": { "application/problem+json": { "example": { "code": "missing_token", "incidentId": "29c07d12-6fef-3da7-b49d-0a693b696405", "solution": "request_token", "title": "Token cannot be empty" }, "schema": { "additionalProperties": true, "description": "The problem indicated by the 401 error response from the SIA Config API.", "properties": { "code": { "description": "The problem type.", "minLength": 1, "type": "string" }, "incidentId": { "description": "The unique ID for this incident.", "type": "string" }, "solution": { "description": "A short, human-readable problem solution.", "type": "string" }, "title": { "description": "A short, human-readable summary of the problem type.", "minLength": 1, "type": "string" } }, "required": [ "code", "title", "incidentId", "solution" ], "type": "object", "x-akamai": { "file-path": "schemas/problem-401.yaml" } } } }, "description": "[Authentication error](https://techdocs.akamai.com/etp-config/reference/401). See [Get started](https://techdocs.akamai.com/etp-config/reference/get-started) for help setting up your API token.", "x-akamai": { "file-path": "errors/unauthorized-401.yaml" } }, "403": { "content": { "application/problem+json": { "example": { "detail": "Insufficient permissions. Code-01", "instance": "3e3f11da-e205-409a-be77-24e459f29fa8", "status": 403, "title": "Forbidden", "type": "https://problems.omni.akamaiapis.net/http/forbidden" }, "schema": { "additionalProperties": true, "description": "The problem indicated by the error response from the SIA Config API.", "properties": { "detail": { "description": "A human-readable explanation specific to the problem.", "minLength": 1, "type": "string" }, "errors": { "description": "A list of HTTP problem details. The error response includes this list if there are several problems with a single request, to call out each of them separately.", "items": { "description": "A nested problem object.", "type": "object", "x-akamai": { "file-path": "schemas/problem-nested.yaml" } }, "minItems": 0, "type": "array" }, "instance": { "description": "The URI for this error occurrence.", "type": "string" }, "status": { "description": "The HTTP status code generated by the origin server.", "minimum": 0, "type": "integer" }, "title": { "description": "A short, human-readable summary of the problem type.", "minLength": 1, "type": "string" }, "type": { "description": "A URI reference that identifies the problem type.", "minLength": 1, "type": "string" } }, "required": [ "type", "title", "detail", "instance", "status" ], "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Insufficient permissions](https://techdocs.akamai.com/etp-config/reference/403) See [Get started](https://techdocs.akamai.com/etp-config/reference/get-started) for help setting up your API token.", "x-akamai": { "file-path": "errors/insufficient-permissions-403.yaml" } }, "404": { "content": { "application/problem+json": { "example": { "detail": "Code-090209", "instance": "aeb030ed-0645-484d-93e2-77e88566312c", "status": 404, "title": "Not Found", "type": "https://problems.omni.akamaiapis.net/http/not-found" }, "schema": { "additionalProperties": true, "description": "The problem indicated by the error response from the SIA Config API.", "properties": { "detail": { "description": "A human-readable explanation specific to the problem.", "minLength": 1, "type": "string" }, "errors": { "description": "A list of HTTP problem details. The error response includes this list if there are several problems with a single request, to call out each of them separately.", "items": { "description": "A nested problem object.", "type": "object", "x-akamai": { "file-path": "schemas/problem-nested.yaml" } }, "minItems": 0, "type": "array" }, "instance": { "description": "The URI for this error occurrence.", "type": "string" }, "status": { "description": "The HTTP status code generated by the origin server.", "minimum": 0, "type": "integer" }, "title": { "description": "A short, human-readable summary of the problem type.", "minLength": 1, "type": "string" }, "type": { "description": "A URI reference that identifies the problem type.", "minLength": 1, "type": "string" } }, "required": [ "type", "title", "detail", "instance", "status" ], "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Configuration not Found.](https://techdocs.akamai.com/etp-config/reference/404)", "x-akamai": { "file-path": "errors/not-found-404.yaml" } } }, "summary": "Create a new proxy certificate", "tags": [ "Proxy certificates" ] }, "parameters": [ { "description": "A unique identifier for the configuration.", "in": "path", "name": "configId", "required": true, "schema": { "example": 456, "type": "integer" }, "x-akamai": { "file-path": "parameters/config-id-path.yaml" } } ], "x-akamai": { "file-path": "paths/certificates.yaml", "path-info": "/customers/{configId}/certificates" } } }, "servers": [ { "url": "https://{hostname}/etp-config/v3" } ], "tags": [ { "description": "TLS certificates allow you to establish a secure connection using the public key provided by your certificate authority (CA). You can specify an Akamai-issued certificate or a customer-provisioned certificate using a trusted third-party CA.", "name": "Proxy certificates" } ], "x-akamai": { "auth-type": "EDGE_GRID", "file-path": "01-tls.yaml" }, "x-readme": { "samples-languages": [ "curl", "python", "node" ], "explorer-enabled": true, "proxy-enabled": true } } ``` # Sibling pages * [List proxy certificates](https://techdocs.akamai.com/etp-config/reference/get-customers-certificates.md) * [Get a proxy certificate](https://techdocs.akamai.com/etp-config/reference/get-customers-certificate.md) * [Modify a proxy certificate](https://techdocs.akamai.com/etp-config/reference/put-customers-certificate.md) * [Activate a proxy certificate](https://techdocs.akamai.com/etp-config/reference/post-customers-certificate-activate.md) * [Confirm a proxy certificate's distribution](https://techdocs.akamai.com/etp-config/reference/post-certificate-confirm-distribution.md) * [Confirm a proxy certificate's download](https://techdocs.akamai.com/etp-config/reference/post-certificate-confirm-download.md) * [Deactivate a proxy certificate](https://techdocs.akamai.com/etp-config/reference/post-certificate-deactivate.md)