KintsugiKintsugi

Initiate a bulk certificate upload

POST/certificate-imports/upload-urls

Begin a bulk certificate upload in the resolved organization. Creates a certificate-import row per file and returns an uploadSessionId plus a presigned S3 upload target for each. POST each file as multipart/form-data to its uploadUrl including every uploadFields entry, then call the confirm endpoint with the same uploadSessionId. A free plan is refused with 403 PLAN_UPGRADE_REQUIRED. A paid plan without exemption certificate management is refused with 403 FORBIDDEN.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Body

filesCertificateImportFile[]Required

The files to upload in this batch.

Response

uploadSessionIdstringRequired

Identifier grouping every file in this upload batch. Pass it to the confirm and list-by-session endpoints.

filesCertificateImportUploadTarget[]Required

One presigned upload target per requested file.

201

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

409

The request conflicts with existing state.

422

The request failed validation.

cURL
POST /certificate-imports/upload-urls
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"files": [
{
"fileName": "resale-certificate.pdf",
"mimeType": "application/pdf"
}
]
}
Response
{
"uploadSessionId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"files": [
{
"certificateImportId": "ecim_2mNpQr7Ls8f3k",
"fileName": "resale-certificate.pdf",
"uploadUrl": "https://s3.amazonaws.com/kintsugi-certificate-imports",
"uploadFields": [
{
"key": "x-amz-meta-organization-id",
"value": "orgn_2mNpQr7Ls8f3k"
}
]
}
]
}
Initiate a bulk certificate upload (2026-07-21) | Kintsugi API Reference