API Reference›Servicing Plane›Core bindings›Create a core binding

Create a core binding

POSThttps://sandbox.api.lendeasy.ai/v1/servicing/core-bindingsRoadmapBearer token ·MANAGE_CORE_BINDING

Creates an isolated BYOC binding with authentication, tenant, and adapter metadata; secrets are write-only.

Roadmap contract. This operation is published product direction and is not registered by the current servicing runtime. Check API availability before building an integration.

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/core-bindings \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Primary lending core",
  "adapterType": "custom_https",
  "baseUrl": "https://core.example.test/lendeasy",
  "authentication": {
    "type": "oauth2_client_credentials",
    "secretReference": "vault://core-prod"
  }
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/core-bindings`, {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "Idempotency-Key": idempotencyKey, "Content-Type": "application/json" },
  body: JSON.stringify({
  "name": "Primary lending core",
  "adapterType": "custom_https",
  "baseUrl": "https://core.example.test/lendeasy",
  "authentication": {
    "type": "oauth2_client_credentials",
    "secretReference": "vault://core-prod"
  }
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/core-bindings",
  headers={"Authorization": f"Bearer {token}", "Idempotency-Key": idempotency_key},
  json={
  "name": "Primary lending core",
  "adapterType": "custom_https",
  "baseUrl": "https://core.example.test/lendeasy",
  "authentication": {
    "type": "oauth2_client_credentials",
    "secretReference": "vault://core-prod"
  }
},
)

{
  "bindingId": "core_47K",
  "name": "Primary lending core",
  "status": "configuration_required"
}

{
  "type": "https://docs.lendeasy.ai/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "code": "unauthorized",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "code": "forbidden",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/version_conflict",
  "title": "Version Conflict",
  "status": 409,
  "code": "version_conflict",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/validation_error",
  "title": "Validation Error",
  "status": 422,
  "code": "validation_error",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/rate_limited",
  "title": "Rate Limited",
  "status": 429,
  "code": "rate_limited",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

Path & query parameters

Field	Type	Description
Idempotency-Key required in header	string	Stable key for this one logical mutation. Reuse it for retries; reusing it with a different request returns 409.

Body parameters

Field	Type	Description
name required	string
adapterType required	string
baseUrl required	string
authentication required	object
type	string
secretReference	string

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/core-bindings \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Primary lending core",
  "adapterType": "custom_https",
  "baseUrl": "https://core.example.test/lendeasy",
  "authentication": {
    "type": "oauth2_client_credentials",
    "secretReference": "vault://core-prod"
  }
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/core-bindings`, {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "Idempotency-Key": idempotencyKey, "Content-Type": "application/json" },
  body: JSON.stringify({
  "name": "Primary lending core",
  "adapterType": "custom_https",
  "baseUrl": "https://core.example.test/lendeasy",
  "authentication": {
    "type": "oauth2_client_credentials",
    "secretReference": "vault://core-prod"
  }
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/core-bindings",
  headers={"Authorization": f"Bearer {token}", "Idempotency-Key": idempotency_key},
  json={
  "name": "Primary lending core",
  "adapterType": "custom_https",
  "baseUrl": "https://core.example.test/lendeasy",
  "authentication": {
    "type": "oauth2_client_credentials",
    "secretReference": "vault://core-prod"
  }
},
)

{
  "bindingId": "core_47K",
  "name": "Primary lending core",
  "status": "configuration_required"
}

{
  "type": "https://docs.lendeasy.ai/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "code": "unauthorized",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "code": "forbidden",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/version_conflict",
  "title": "Version Conflict",
  "status": 409,
  "code": "version_conflict",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/validation_error",
  "title": "Validation Error",
  "status": 422,
  "code": "validation_error",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/rate_limited",
  "title": "Rate Limited",
  "status": 429,
  "code": "rate_limited",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}