KintsugiKintsugi
API reference / Validate campfire credentials

Validate campfire credentials

POST/connections/campfire/validate

Probe Campfire GET /coa/api/entity with the supplied API key, returning the entities it can access. Returns 400 if the key is invalid or has no accessible entities. Returns 503 if Campfire cannot be reached.

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

apiKeystringRequired

Campfire API key to probe.

Response

entitiesCampfireValidateEntity[]

Entities available under the validated key.

200

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.

422

The request failed validation.

503

A service this request depends on was unavailable. Retry the request.

cURL
POST /connections/campfire/validate
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"apiKey": "********"
}
Response
{
"entities": [
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"name": "Acme Corp",
"currency": "USD"
}
]
}
Validate campfire credentials (2026-07-21) | Kintsugi API Reference