---
title: "Request ACME certificate"
method: POST
path: "/apps/{app_name}/certificates/acme"
tags: ["TLS Certificates"]
---

# Request ACME certificate

`POST /apps/{app_name}/certificates/acme`

## Path parameters

- `app_name` string, required

## Request body

- CreateAcmeCertificateRequest
  - `hostname` string

## Response `201`

Created

- CertificateDetail
  - `acme_requested` boolean
  - `certificates` CertificateEntry[]
    - `created_at` string
    - `expires_at` string
    - `issued` IssuedCertificate[]
      - `certificate_authority` string
      - `expires_at` string
      - `type` 'rsa' | 'ecdsa'
    - `issuer` string
    - `source` 'custom' | 'fly'
    - `status` 'active' | 'pending_ownership' | 'pending_validation'
  - `configured` boolean
  - `dns_provider` string
  - `dns_requirements` DNSRequirements
    - `a` string[]
    - `aaaa` string[]
    - `acme_challenge` AcmeChallenge
      - `name` string
      - `target` string
    - `cname` string
    - `ownership` OwnershipVerification
      - `app_value` string
      - `name` string
      - `org_value` string
  - `hostname` string
  - `rate_limited_until` string
  - `status` string
  - `validation` CertificateValidation
    - `alpn_configured` boolean
    - `dns_configured` boolean
    - `http_configured` boolean
    - `ownership_txt_configured` boolean
  - `validation_errors` CertificateValidationError[]
    - `code` string
    - `message` string
    - `remediation` string
    - `timestamp` string

## Other responses

- `422` — Unprocessable Entity

---

[API](https://skmtc.net/machines/apis/machines-api.md) · [All operations](https://skmtc.net/machines/apis/machines-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/machines/machines-api/versions/633ddedda749/schema)