--- title: Create Custom CSR --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [Custom Csrs](https://developers.cloudflare.com/api/typescript/resources/custom_csrs) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create Custom CSR client.customCsrs.create(CustomCsrCreateParams {common\_name, country, locality, 9 more } params, RequestOptionsoptions?): [CustomCsrCreateResponse]() {id, created\_at, key\_type, 11 more } POST/{accounts\_or\_zones}/{account\_or\_zone\_id}/custom\_csrs Generate a new custom Certificate Signing Request (CSR) for an account or zone. Cloudflare generates and securely stores the private key associated with the CSR. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `Account: SSL and Certificates Write` ##### ParametersExpand Collapse
params: CustomCsrCreateParams {common\_name, country, locality, 9 more } common\_name: string Body param: The common name (domain) for the CSR. Must be at most 64 characters. maxLength64 Link to this property country: string Body param: Two-letter ISO 3166-1 alpha-2 country code. Link to this property locality: string Body param: City or locality name. Link to this property organization: string Body param: Organization name. Link to this property sans: Array<string> Body param: Subject Alternative Names for the CSR. At least one SAN is required. Link to this property state: string Body param: State or province name. Link to this property account\_id?: string Path param: The Account ID to use for this endpoint. Mutually exclusive with the Zone ID. Link to this property zone\_id?: string Path param: The Zone ID to use for this endpoint. Mutually exclusive with the Account ID. Link to this property description?: string Body param: Optional description for the CSR. Link to this property
key\_type?: "rsa2048"| "p256v1" Body param: Key algorithm to use for the CSR. Defaults to rsa2048 if not specified. One of the following: "rsa2048" Link to this property "p256v1" Link to this property
Link to this property name?: string Body param: Human-readable name for the CSR. Link to this property organizational\_unit?: string Body param: Organizational unit name. Link to this property
[Link to this property](<#(resource)%20custom_csrs%20%3E%20(method)%20create%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
CustomCsrCreateResponse {id, created\_at, key\_type, 11 more } A custom Certificate Signing Request (CSR). id: string Custom CSR identifier tag. maxLength36 Link to this property created\_at: string When the CSR was created. formatdate-time Link to this property
key\_type: "rsa2048"| "p256v1" The key algorithm used to generate the CSR. One of the following: "rsa2048" Link to this property "p256v1" Link to this property
Link to this property account\_tag?: string Account identifier associated with this CSR. Link to this property common\_name?: string The common name (domain) for the CSR. maxLength64 Link to this property country?: string Two-letter ISO 3166-1 alpha-2 country code. Link to this property csr?: string The PEM-encoded Certificate Signing Request. Link to this property description?: string Optional description for the CSR. Link to this property locality?: string City or locality name. Link to this property name?: string Human-readable name for the CSR. Link to this property organization?: string Organization name. Link to this property organizational\_unit?: string Organizational unit name. Link to this property sans?: Array<string> Subject Alternative Names included in the CSR. Link to this property state?: string State or province name. Link to this property
[Link to this property](<#(resource)%20custom_csrs%20%3E%20(model)%20custom_csr_create_response%20%3E%20(schema)>) ### Create Custom CSR TypeScript HTTPTypeScriptPythonGoTerraform ``` import Cloudflare from 'cloudflare'; const client = new Cloudflare({ apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted }); const customCsr = await client.customCsrs.create({ common_name: 'example.com', country: 'US', locality: 'San Francisco', organization: 'Cloudflare, Inc.', sans: ['example.com', 'www.example.com'], state: 'California', account_id: 'account_id', }); console.log(customCsr.id); ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "7b163417-1d2b-4c84-a38a-2fb7a0cd7752", "created_at": "2024-01-15T10:30:00Z", "key_type": "rsa2048", "account_tag": "23e087bd19bc1d40ae95b6f297263ceb", "common_name": "example.com", "country": "US", "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICYzCCAUsCAQAwHj...", "description": "CSR for example.com wildcard", "locality": "San Francisco", "name": "My Custom CSR", "organization": "Cloudflare, Inc.", "organizational_unit": "Engineering", "sans": [ "example.com", "www.example.com" ], "state": "California" } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "7b163417-1d2b-4c84-a38a-2fb7a0cd7752", "created_at": "2024-01-15T10:30:00Z", "key_type": "rsa2048", "account_tag": "23e087bd19bc1d40ae95b6f297263ceb", "common_name": "example.com", "country": "US", "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICYzCCAUsCAQAwHj...", "description": "CSR for example.com wildcard", "locality": "San Francisco", "name": "My Custom CSR", "organization": "Cloudflare, Inc.", "organizational_unit": "Engineering", "sans": [ "example.com", "www.example.com" ], "state": "California" } } ```