Upload digital certificate
POST/v1/certificates
Uploads an A1 digital certificate via multipart/form-data. The private key and password are encrypted at rest and are never returned by the API. The endpoint detects duplicates by thumbprint and automatically associates the certificate with a person based on the extracted CNPJ/CPF.
Accepted type values:
pfx— sendfile(binary PFX/P12) andpassword.cert_key— sendcert_file(certificate PEM) andkey_file(key PEM).combined_pem— sendfile(PEM containing certificate + key).cert_key_password— sendcert_file,key_fileandpassword(password-protected key).
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 422
- 429
- 500
Certificate uploaded and stored successfully.
Request body failed validation.
Missing or invalid bearer token.
Token is valid but lacks permission for this operation.
Resource not found in the current organization.
Request body failed validation.
Rate limit exceeded.
Unexpected server error.